@behio/storefront-sdk 0.42.0 → 1.1.0

package/dist/{client-B0vlHxB1.d.ts → client-CiowRIBp.d.ts}

@@ -271,7 +271,55 @@ interface ProductVariant {
      */
     id: string;
     sku: string;
+    /**
+     * Variant name in the requested locale. Before SDK 1.1.0 this was always the
+     * warehouse item name, so translated shops showed one language to everyone.
+     */
     name: string;
+    /**
+     * Deep-link token for this variant — NOT a URL of its own.
+     *
+     * A variant has no standalone product page: the catalog 404s its slug and
+     * every listing excludes it, because a variant is bought from the parent's
+     * detail page. Link to `/product/{product.slug}?variant={variant.variantSlug}`
+     * and preselect the variant from that query parameter.
+     *
+     * Added in SDK 1.1.0.
+     */
+    variantSlug: string;
+    /**
+     * Short description of THIS variant, or `null` when the merchant left it
+     * empty. `null` means INHERIT: fall back to `ProductDetail.shortDescription`
+     * instead of rendering an empty block. Sanitised HTML.
+     *
+     * Added in SDK 1.1.0.
+     */
+    shortDescription?: string | null;
+    /** Long description of THIS variant. Same inherit-on-null contract as
+     *  `shortDescription`. Added in SDK 1.1.0. */
+    longDescription?: string | null;
+    /**
+     * Gallery of THIS variant, ordered. Empty means the variant has no photos of
+     * its own, so keep showing the parent's gallery.
+     *
+     * Added in SDK 1.1.0.
+     */
+    images: ProductDetail["images"];
+    /**
+     * Per-variant SEO/OG overrides, or `null` when the merchant wrote none. The
+     * canonical URL stays the parent's, so use these only when a variant is
+     * preselected via `?variant=`.
+     *
+     * Added in SDK 1.1.0.
+     */
+    seo?: {
+        title?: string | null;
+        description?: string | null;
+        keywords?: string | null;
+        ogTitle?: string | null;
+        ogDescription?: string | null;
+        ogImage?: string | null;
+    } | null;
     /**
      * Axis name/value pairs identifying this variant (e.g.
      * `[{name: 'Barva', value: 'červená'}]`) — matches the wire shape the API
@@ -300,6 +348,14 @@ interface ProductVariant {
      * "default photo" or to render the picture in a subtler style.
      */
     imageIsInherited: boolean;
+    /**
+     * Parameters of this variant. A variant carries its own value where it has
+     * one and inherits the parent's everywhere else, so you can render the rows
+     * that actually differ under each variant. Empty when nothing is assigned.
+     *
+     * Added in SDK 1.0.0.
+     */
+    parameterGroups: ProductParameterGroup[];
 }
 interface ProductLabel {
     id: string;
@@ -513,25 +569,41 @@ interface VariantAxis {
     values: VariantAxisValue[];
 }
 /**
- * One custom-field (data-group value) rendered as a spec-table row. BOOLEAN
- * carries a typed `booleanValue` (value is null) so the storefront can localize
- * Ano/Ne; MONEY carries its currency in `unit`; PERCENTAGE carries "%" in
- * `unit`.
+ * One row of a curated parameter group.
+ *
+ * A parameter is something the merchant explicitly published: a label they
+ * wrote, a value resolved from a fixed string, a product field, or ONE named
+ * field of one warehouse data group. Nothing here reveals warehouse structure:
+ * no ids, no field keys, no internal types.
+ *
+ * `value` is null only for boolean parameters, where `booleanValue` carries the
+ * typed value so the storefront localizes Ano/Ne itself. A parameter with no
+ * value is omitted from the array rather than rendered as an empty row.
  */
-interface ProductCustomField {
-    key: string;
-    name: string;
-    /** TEXT | NUMBER | DECIMAL | BOOLEAN | DATE | TIME | DATETIME | PERCENTAGE | MONEY | ITEM_LIST | ... */
-    type: string;
+interface ProductParameter {
+    label: string;
     value: string | null;
     booleanValue: boolean | null;
+    /** "cm", "g", a currency code, "%"; null when the parameter has none. */
     unit: string | null;
 }
-/** A spec-table section (one inventory data group) with its fields. */
-interface ProductCustomFieldGroup {
-    key: string;
+/**
+ * One curated parameter group. A product can carry several, so a template can
+ * render one as a spec table and another as badges. Ordering is array order,
+ * both for the groups and for the parameters inside them.
+ */
+interface ProductParameterGroup {
+    /**
+     * Stable public identifier derived from the merchant's own group name
+     * ("Parametry oblečení" -> "parametry-obleceni"). Pass it to
+     * `catalog.getProductParameterGroup` to fetch just this group.
+     */
+    slug: string;
     name: string;
-    fields: ProductCustomField[];
+    parameters: ProductParameter[];
+}
+interface ProductParametersResponse {
+    groups: ProductParameterGroup[];
 }
 interface ProductDetail extends ProductListItem {
     longDescription?: string;
@@ -561,14 +633,15 @@ interface ProductDetail extends ProductListItem {
     variantAxes: VariantAxis[];
     volumePricing: ProductVolumePrice[];
     /**
-     * Structured product parameters from custom fields (inventory data groups),
-     * grouped into spec-table sections (GAP-12). Empty when the product has no
-     * data-group values. Distinct from `longDescription` (free HTML): this is
-     * machine-readable key/value data for a "Parametry" table + comparison
-     * engines. (Corrected from the old untyped `Record<string, unknown>` — the
-     * API never populated that; it now sends this structured shape.)
+     * Curated parameter groups, already resolved. Empty when the merchant
+     * assigned none. Distinct from `longDescription` (free HTML): this is
+     * machine-readable key/value data for a "Parametry" table, comparison
+     * engines and AEO.
+     *
+     * Replaced `customFields` in SDK 1.0.0. The old field returned raw warehouse
+     * data groups, which published internal bookkeeping nobody curated.
      */
-    customFields: ProductCustomFieldGroup[];
+    parameterGroups: ProductParameterGroup[];
     seo: {
         title?: string | null;
         description?: string | null;
@@ -675,13 +748,22 @@ interface CategoryDetail extends Category {
         ogImage?: string | null;
     };
 }
-type DataGroupFieldType = "TEXT" | "NUMBER" | "DECIMAL" | "BOOLEAN" | "DATE" | "TIME" | "DATETIME" | "PERCENTAGE" | "MONEY" | "ASSET" | "ITEM_LIST" | "DYNAMIC_NUMBER_CALCULATION_FROM_OTHERS";
+/**
+ * One available filter, derived from a curated parameter the merchant marked
+ * filterable. A visitor can therefore never filter by a field that does not
+ * appear in the product's parameters.
+ */
 interface FilterField {
+    /** Parameter slug. Pass it back in `ProductsQuery.parameters` or `facets`. */
     key: string;
+    /** Parameter label in the requested language. */
     name: string;
-    type: DataGroupFieldType | string;
-    groupKey: string;
+    /** How to render it: value list, numeric range, or yes/no. */
+    type: "enum" | "range" | "boolean" | string;
+    /** Slug of the parameter group this filter belongs to. */
+    groupSlug: string;
     groupName: string;
+    unit?: string | null;
     values?: string[];
 }
 interface FacetValue {
@@ -701,14 +783,14 @@ interface FacetRange {
     max: number | null;
 }
 interface Facet {
+    /** Parameter slug. Never a warehouse field key. */
     key: string;
     name: string;
     /** "enum" (checkboxes), "range" (slider) or "boolean". */
     type: "enum" | "range" | "boolean" | string;
-    groupKey: string;
+    /** Slug of the parameter group this facet belongs to. */
+    groupSlug: string;
     groupName: string;
-    /** Underlying data-group field type (TEXT, NUMBER, MONEY, ...). */
-    fieldType: string;
     /** enum/boolean facets: selectable values with counts. */
     values?: FacetValue[];
     /** range facets: numeric bounds within the current context. */
@@ -803,11 +885,17 @@ interface ProductsQuery {
     /** Minimum aggregate rating, e.g. 4 for "4 and up". */
     ratingMin?: number;
     search?: string;
-    /** Custom-field filters. A value may be an array = multi-select (OR within
-     *  the key), e.g. {"barva": ["cerna", "bila"]}. */
-    customFields?: Record<string, string | number | boolean | string[] | unknown>;
-    /** Slug-based facet selection for SEO URLs: facet key -> value slugs, e.g.
-     *  {"barva": ["cerna"]}. Resolved server-side to the underlying values. */
+    /**
+     * Parameter filters, keyed by PARAMETER SLUG. A value may be an array =
+     * multi-select (OR within the key), e.g. {"barva": ["cerna", "bila"]}.
+     * Range filters use the `_min` / `_max` suffix, e.g. {"hmotnost_min": 100}.
+     *
+     * Replaced `customFields` in SDK 1.0.0, which was keyed by a warehouse
+     * data-group field key.
+     */
+    parameters?: Record<string, string | number | boolean | string[] | unknown>;
+    /** Slug-based facet selection for SEO URLs: parameter slug -> value slugs,
+     *  e.g. {"barva": ["cerna"]}. Resolved server-side to the stored values. */
     facets?: Record<string, string[]>;
     /** Filter by specific product IDs (comma-separated in URL) */
     ids?: string[];
@@ -852,7 +940,22 @@ interface LoginInput {
     password: string;
 }
 interface CartItemProduct {
+    /**
+     * Slug of the page this line links to. For a variant line this is the
+     * PARENT's slug: a variant has no page of its own, so linking to its own slug
+     * landed customers on a 404 (fixed 2026-08-03, SDK 1.1.0).
+     */
     slug: string;
+    /**
+     * Deep-link token of the variant on this line, `null` for a plain product.
+     * Build the link as `/product/{slug}?variant={variantSlug}` so the customer
+     * returns to the exact variant sitting in their cart.
+     *
+     * Added in SDK 1.1.0.
+     */
+    variantSlug?: string | null;
+    /** Product name in the CART's language. Before SDK 1.1.0 the API picked an
+     *  arbitrary translation row, so this could come back in another language. */
     name: string;
     sku: string;
     imageUrl?: string;
@@ -1146,7 +1249,10 @@ interface DigitalDownload {
     fileName: string;
     /** Localized product name the file belongs to (may be null). */
     productName: string | null;
-    /** Product slug for linking back to the PDP (may be null). */
+    /**
+     * Product slug for linking back to the PDP (may be null). Resolved the same
+     * way as everywhere else: per-locale slug first, then the product id.
+     */
     productSlug: string | null;
     fileSize: number;
     mimeType: string;
@@ -1168,7 +1274,10 @@ interface CourseListItem {
     courseId: string;
     /** Localized course (product) name, best-effort. */
     name: string | null;
-    /** Product slug for linking to the PDP. */
+    /**
+     * Product slug for linking to the PDP. Resolved the same way as in the
+     * catalog: per-locale slug first, then the product id.
+     */
     slug: string;
     imageUrl: string | null;
     totalLessons: number;
@@ -1220,6 +1329,7 @@ interface CourseModule {
 interface CourseDetail {
     courseId: string;
     name: string | null;
+    /** Product slug for linking to the PDP (resolved per-locale slug, else id). */
     slug: string;
     imageUrl: string | null;
     /** Welcome text shown at the top of the member area (markdown). */
@@ -1572,15 +1682,17 @@ interface Bundle {
     slug: string;
     name: string;
     description: string | null;
-    bundlePrice: number;
+    /** `null` when the eshop hides prices from guests and this visitor has no price entitlement. */
+    bundlePrice: number | null;
     currency: string;
     coverImage: string | null;
     endsAt: number | null;
-    itemsSum: number;
-    /** Absolute saving vs buying the components separately, in `currency`. */
-    savings: number;
-    /** Percentage saving, 0–100. 0 when `itemsSum` is zero. */
-    savingsPercent: number;
+    /** `null` when prices are hidden (see `bundlePrice`). */
+    itemsSum: number | null;
+    /** Absolute saving vs buying the components separately, in `currency`. `null` when prices are hidden. */
+    savings: number | null;
+    /** Percentage saving, 0–100. 0 when `itemsSum` is zero. `null` when prices are hidden. */
+    savingsPercent: number | null;
     /** Minimum bundles per order. Default 1. */
     minQuantity: number;
     /** Maximum bundles per order. `null` = uncapped. */
@@ -2284,15 +2396,42 @@ declare class CatalogModule {
         locale?: string;
         currency?: string;
     }): Promise<SdkResult<PaginatedResponse<ProductListItem>>>;
-    /** Get available filter fields for dynamic filter UI */
-    getFilters(): Promise<SdkResult<{
+    /**
+     * Available filters for a dynamic filter UI.
+     *
+     * Derived from curated PARAMETERS the merchant marked filterable, so a
+     * visitor can never filter by something that does not appear in the
+     * product's parameters. Labels are per language, hence `locale`.
+     */
+    getFilters(options?: {
+        locale?: string;
+    }): Promise<SdkResult<{
         filters: FilterField[];
     }>>;
     /**
-     * Facet groups + selection-aware counts for the current filter set (custom
-     * fields, labels, price, availability, rating, subcategories). Pass the SAME
-     * query you pass to `getProducts` (category, search, price, inStock, ratingMin,
-     * customFields, facets slugs, labels): counts for each facet are computed with
+     * Curated parameter groups of a product, already resolved (label, value,
+     * unit, order). Returns an ARRAY of groups so a template can lay them out
+     * however it likes: one group as a spec table, another as badges.
+     *
+     * A variant's own parameters ride along on `ProductDetail.variants[]`, so
+     * this call is for the parent product.
+     */
+    getProductParameters(slug: string, options?: {
+        locale?: string;
+    }): Promise<SdkResult<ProductParametersResponse>>;
+    /**
+     * One specific parameter group of a product, by its slug. 404 when the
+     * product does not have that group, which is deliberate: the caller asked
+     * for a named thing, so an empty array would hide a wrong slug.
+     */
+    getProductParameterGroup(slug: string, groupSlug: string, options?: {
+        locale?: string;
+    }): Promise<SdkResult<ProductParameterGroup>>;
+    /**
+     * Facet groups + selection-aware counts for the current filter set
+     * (parameters, labels, price, availability, rating, subcategories). Pass the
+     * SAME query you pass to `getProducts` (category, search, price, inStock,
+     * ratingMin, parameters, facets slugs, labels): counts are computed with
      * that facet excluded, and values that drop to 0 are still returned (render
      * them disabled). Use this to build an Alza-style filter sidebar.
      */
@@ -2794,4 +2933,4 @@ declare class NewsletterModule {
     unsubscribe(email: string): Promise<SdkResult<NewsletterUnsubscribeResult>>;
 }
 
-export { type DownloadUrl as $, type ActivePromotion as A, BehioStorefront as B, type CookieConsent as C, type CheckoutAddress as D, type CheckoutInput as E, type CheckoutPaymentMethod as F, type CheckoutSettings as G, type CookieConsentInput as H, type CourseAttachment as I, type CourseCertificate as J, type CourseComment as K, type CourseCommentReply as L, type CourseCommentsList as M, type CourseDetail as N, type CourseLesson as O, type CourseListItem as P, type CourseModule as Q, type CoursePostedComment as R, type SdkResult as S, type CourseProgress as T, type CourseTutorMessage as U, type CourseTutorThread as V, type CrossSellItem as W, type CustomerAddress as X, type CustomerProfile as Y, type DataGroupFieldType as Z, type DigitalDownload as _, type AddToCartInput as a, type ProductPrice as a$, type Facet as a0, type FacetAvailability as a1, type FacetCategory as a2, type FacetLabel as a3, type FacetPriceRange as a4, type FacetRange as a5, type FacetRatingBucket as a6, type FacetValue as a7, type FacetsResponse as a8, type FilterField as a9, type OrderAccessVerifyResponse as aA, type OrderDetail as aB, type OrderItem as aC, type OrderListItem as aD, type OrderStatus as aE, type OrderStatusHistory as aF, OrderStatuses as aG, type OrderTracking as aH, type Page as aI, type PageAttachment as aJ, type PageDetail as aK, type PaginatedResponse as aL, type PaymentStatus as aM, PaymentStatuses as aN, type PickupPoint as aO, type PickupPointHours as aP, type PickupPointsInput as aQ, type PriceDisplay as aR, type ProductAvailability as aS, type ProductCustomField as aT, type ProductCustomFieldGroup as aU, type ProductDetail as aV, type ProductGroup as aW, type ProductLabel as aX, type ProductListItem as aY, type ProductMedia as aZ, type ProductMediaVariant as a_, type FulfillmentStatus as aa, FulfillmentStatuses as ab, type GiftCardBalance as ac, type GiftCardPurchaseInput as ad, type GiftCardPurchaseResult as ae, type GiftCardSummary as af, type LessonNote as ag, type LessonQuiz as ah, type LoginInput as ai, type LoyaltyBalance as aj, type LoyaltyNextTier as ak, type LoyaltyProgram as al, type LoyaltySummary as am, type LoyaltyTier as an, type LoyaltyTierPerks as ao, type LoyaltyTransaction as ap, type Menu as aq, type MenuItem as ar, type MenuItemRef as as, type MenuItemType as at, type MessageResponse as au, type NewsletterOptInDefault as av, type NewsletterSubscribeInput as aw, type NewsletterSubscribeResult as ax, type NewsletterUnsubscribeResult as ay, type OrderAccessRequestResponse as az, type AddressDetail as b, type ProductPromotionSummary as b0, type ProductReview as b1, type ProductReviewsResponse as b2, ProductSort as b3, type ProductSortValue as b4, type ProductVariant as b5, type ProductVolumePrice as b6, type ProductsQuery as b7, type QuizAnswerInput as b8, type QuizAnswerResult as b9, type ShopSeoIdentity as bA, type StockBehavior as bB, type StockMode as bC, type SubmitQuoteInput as bD, type SubmitReturnInput as bE, type SubmitReviewInput as bF, type Subscription as bG, type SubscriptionAction as bH, type SubscriptionFrequency as bI, type SubscriptionItem as bJ, type SubscriptionStatus as bK, type TaxBreakdownLine as bL, type VariantAxis as bM, type VariantAxisValue as bN, type WishlistItem as bO, err as bP, ok as bQ, toSdkError as bR, type QuizQuestion as ba, type QuizResult as bb, type QuoteItem as bc, type QuoteRequest as bd, type RegisterInput as be, type RegisterResult as bf, type RequestInterceptor as bg, type RequestInterceptorConfig as bh, type ResponseInterceptor as bi, type ResponseInterceptorData as bj, type ReturnRequest as bk, type ReturnRequestItem as bl, type ReturnStatus as bm, type ReturnStatusItem as bn, type ReturnableOrder as bo, type ReturnableOrderItem as bp, type SdkError as bq, type ShippingMethodSummary as br, type ShippingQuote as bs, type ShippingQuoteInput as bt, type ShopInfo as bu, type ShopScript as bv, type ShopScriptPlacement as bw, type ShopScriptType as bx, type ShopScripts as by, type ShopSeo as bz, type AddressSuggestion as c, type AddressType as d, AddressTypes as e, type AuthTokens as f, type BackInStockSubscription as g, type BadgeTone as h, BehioApiError as i, type BehioErrorCode as j, type BehioEventHandler as k, type BehioEventType as l, BehioNetworkError as m, type BehioStorefrontConfig as n, type Bundle as o, type BundleItem as p, type Cart as q, type CartBundleLine as r, type CartBundleLineItem as s, type CartDiscount as t, type CartItem as u, type CartItemProduct as v, type CartPromotion as w, type Category as x, type CategoryDetail as y, type CertificateVerification as z };
+export { type DigitalDownload as $, type ActivePromotion as A, BehioStorefront as B, type CookieConsent as C, type CertificateVerification as D, type CheckoutAddress as E, type CheckoutInput as F, type CheckoutPaymentMethod as G, type CheckoutSettings as H, type CookieConsentInput as I, type CourseAttachment as J, type CourseCertificate as K, type CourseComment as L, type CourseCommentReply as M, type CourseCommentsList as N, type CourseDetail as O, type ProductDetail as P, type CourseLesson as Q, type CourseListItem as R, type SdkResult as S, type CourseModule as T, type CoursePostedComment as U, type CourseProgress as V, type CourseTutorMessage as W, type CourseTutorThread as X, type CrossSellItem as Y, type CustomerAddress as Z, type CustomerProfile as _, type ProductVariant as a, type ProductParametersResponse as a$, type DownloadUrl as a0, type Facet as a1, type FacetAvailability as a2, type FacetCategory as a3, type FacetLabel as a4, type FacetPriceRange as a5, type FacetRange as a6, type FacetRatingBucket as a7, type FacetValue as a8, type FacetsResponse as a9, type OrderAccessRequestResponse as aA, type OrderAccessVerifyResponse as aB, type OrderDetail as aC, type OrderItem as aD, type OrderListItem as aE, type OrderStatus as aF, type OrderStatusHistory as aG, OrderStatuses as aH, type OrderTracking as aI, type Page as aJ, type PageAttachment as aK, type PageDetail as aL, type PaginatedResponse as aM, type PaymentStatus as aN, PaymentStatuses as aO, type PickupPoint as aP, type PickupPointHours as aQ, type PickupPointsInput as aR, type PriceDisplay as aS, type ProductAvailability as aT, type ProductGroup as aU, type ProductLabel as aV, type ProductListItem as aW, type ProductMedia as aX, type ProductMediaVariant as aY, type ProductParameter as aZ, type ProductParameterGroup as a_, type FilterField as aa, type FulfillmentStatus as ab, FulfillmentStatuses as ac, type GiftCardBalance as ad, type GiftCardPurchaseInput as ae, type GiftCardPurchaseResult as af, type GiftCardSummary as ag, type LessonNote as ah, type LessonQuiz as ai, type LoginInput as aj, type LoyaltyBalance as ak, type LoyaltyNextTier as al, type LoyaltyProgram as am, type LoyaltySummary as an, type LoyaltyTier as ao, type LoyaltyTierPerks as ap, type LoyaltyTransaction as aq, type Menu as ar, type MenuItem as as, type MenuItemRef as at, type MenuItemType as au, type MessageResponse as av, type NewsletterOptInDefault as aw, type NewsletterSubscribeInput as ax, type NewsletterSubscribeResult as ay, type NewsletterUnsubscribeResult as az, type AddToCartInput as b, type ProductPrice as b0, type ProductPromotionSummary as b1, type ProductReview as b2, type ProductReviewsResponse as b3, ProductSort as b4, type ProductSortValue as b5, type ProductVolumePrice as b6, type ProductsQuery as b7, type QuizAnswerInput as b8, type QuizAnswerResult as b9, type ShopSeoIdentity as bA, type StockBehavior as bB, type StockMode as bC, type SubmitQuoteInput as bD, type SubmitReturnInput as bE, type SubmitReviewInput as bF, type Subscription as bG, type SubscriptionAction as bH, type SubscriptionFrequency as bI, type SubscriptionItem as bJ, type SubscriptionStatus as bK, type TaxBreakdownLine as bL, type VariantAxis as bM, type VariantAxisValue as bN, type WishlistItem as bO, err as bP, ok as bQ, toSdkError as bR, type QuizQuestion as ba, type QuizResult as bb, type QuoteItem as bc, type QuoteRequest as bd, type RegisterInput as be, type RegisterResult as bf, type RequestInterceptor as bg, type RequestInterceptorConfig as bh, type ResponseInterceptor as bi, type ResponseInterceptorData as bj, type ReturnRequest as bk, type ReturnRequestItem as bl, type ReturnStatus as bm, type ReturnStatusItem as bn, type ReturnableOrder as bo, type ReturnableOrderItem as bp, type SdkError as bq, type ShippingMethodSummary as br, type ShippingQuote as bs, type ShippingQuoteInput as bt, type ShopInfo as bu, type ShopScript as bv, type ShopScriptPlacement as bw, type ShopScriptType as bx, type ShopScripts as by, type ShopSeo as bz, type AddressDetail as c, type AddressSuggestion as d, type AddressType as e, AddressTypes as f, type AuthTokens as g, type BackInStockSubscription as h, type BadgeTone as i, BehioApiError as j, type BehioErrorCode as k, type BehioEventHandler as l, type BehioEventType as m, BehioNetworkError as n, type BehioStorefrontConfig as o, type Bundle as p, type BundleItem as q, type Cart as r, type CartBundleLine as s, type CartBundleLineItem as t, type CartDiscount as u, type CartItem as v, type CartItemProduct as w, type CartPromotion as x, type Category as y, type CategoryDetail as z };

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { B as BehioStorefront, S as SdkResult, C as CookieConsent } from './client-B0vlHxB1.mjs';
-export { A as ActivePromotion, a as AddToCartInput, b as AddressDetail, c as AddressSuggestion, d as AddressType, e as AddressTypes, f as AuthTokens, g as BackInStockSubscription, h as BadgeTone, i as BehioApiError, j as BehioErrorCode, k as BehioEventHandler, l as BehioEventType, m as BehioNetworkError, n as BehioStorefrontConfig, o as Bundle, p as BundleItem, q as Cart, r as CartBundleLine, s as CartBundleLineItem, t as CartDiscount, u as CartItem, v as CartItemProduct, w as CartPromotion, x as Category, y as CategoryDetail, z as CertificateVerification, D as CheckoutAddress, E as CheckoutInput, F as CheckoutPaymentMethod, G as CheckoutSettings, H as CookieConsentInput, I as CourseAttachment, J as CourseCertificate, K as CourseComment, L as CourseCommentReply, M as CourseCommentsList, N as CourseDetail, O as CourseLesson, P as CourseListItem, Q as CourseModule, R as CoursePostedComment, T as CourseProgress, U as CourseTutorMessage, V as CourseTutorThread, W as CrossSellItem, X as CustomerAddress, Y as CustomerProfile, Z as DataGroupFieldType, _ as DigitalDownload, $ as DownloadUrl, a0 as Facet, a1 as FacetAvailability, a2 as FacetCategory, a3 as FacetLabel, a4 as FacetPriceRange, a5 as FacetRange, a6 as FacetRatingBucket, a7 as FacetValue, a8 as FacetsResponse, a9 as FilterField, aa as FulfillmentStatus, ab as FulfillmentStatuses, ac as GiftCardBalance, ad as GiftCardPurchaseInput, ae as GiftCardPurchaseResult, af as GiftCardSummary, ag as LessonNote, ah as LessonQuiz, ai as LoginInput, aj as LoyaltyBalance, ak as LoyaltyNextTier, al as LoyaltyProgram, am as LoyaltySummary, an as LoyaltyTier, ao as LoyaltyTierPerks, ap as LoyaltyTransaction, aq as Menu, ar as MenuItem, as as MenuItemRef, at as MenuItemType, au as MessageResponse, av as NewsletterOptInDefault, aw as NewsletterSubscribeInput, ax as NewsletterSubscribeResult, ay as NewsletterUnsubscribeResult, az as OrderAccessRequestResponse, aA as OrderAccessVerifyResponse, aB as OrderDetail, aC as OrderItem, aD as OrderListItem, aE as OrderStatus, aF as OrderStatusHistory, aG as OrderStatuses, aH as OrderTracking, aI as Page, aJ as PageAttachment, aK as PageDetail, aL as PaginatedResponse, aM as PaymentStatus, aN as PaymentStatuses, aO as PickupPoint, aP as PickupPointHours, aQ as PickupPointsInput, aR as PriceDisplay, aS as ProductAvailability, aT as ProductCustomField, aU as ProductCustomFieldGroup, aV as ProductDetail, aW as ProductGroup, aX as ProductLabel, aY as ProductListItem, aZ as ProductMedia, a_ as ProductMediaVariant, a$ as ProductPrice, b0 as ProductPromotionSummary, b1 as ProductReview, b2 as ProductReviewsResponse, b3 as ProductSort, b4 as ProductSortValue, b5 as ProductVariant, b6 as ProductVolumePrice, b7 as ProductsQuery, b8 as QuizAnswerInput, b9 as QuizAnswerResult, ba as QuizQuestion, bb as QuizResult, bc as QuoteItem, bd as QuoteRequest, be as RegisterInput, bf as RegisterResult, bg as RequestInterceptor, bh as RequestInterceptorConfig, bi as ResponseInterceptor, bj as ResponseInterceptorData, bk as ReturnRequest, bl as ReturnRequestItem, bm as ReturnStatus, bn as ReturnStatusItem, bo as ReturnableOrder, bp as ReturnableOrderItem, bq as SdkError, br as ShippingMethodSummary, bs as ShippingQuote, bt as ShippingQuoteInput, bu as ShopInfo, bv as ShopScript, bw as ShopScriptPlacement, bx as ShopScriptType, by as ShopScripts, bz as ShopSeo, bA as ShopSeoIdentity, bB as StockBehavior, bC as StockMode, bD as SubmitQuoteInput, bE as SubmitReturnInput, bF as SubmitReviewInput, bG as Subscription, bH as SubscriptionAction, bI as SubscriptionFrequency, bJ as SubscriptionItem, bK as SubscriptionStatus, bL as TaxBreakdownLine, bM as VariantAxis, bN as VariantAxisValue, bO as WishlistItem, bP as err, bQ as ok, bR as toSdkError } from './client-B0vlHxB1.mjs';
+import { P as ProductDetail, a as ProductVariant, B as BehioStorefront, S as SdkResult, C as CookieConsent } from './client-CiowRIBp.mjs';
+export { A as ActivePromotion, b as AddToCartInput, c as AddressDetail, d as AddressSuggestion, e as AddressType, f as AddressTypes, g as AuthTokens, h as BackInStockSubscription, i as BadgeTone, j as BehioApiError, k as BehioErrorCode, l as BehioEventHandler, m as BehioEventType, n as BehioNetworkError, o as BehioStorefrontConfig, p as Bundle, q as BundleItem, r as Cart, s as CartBundleLine, t as CartBundleLineItem, u as CartDiscount, v as CartItem, w as CartItemProduct, x as CartPromotion, y as Category, z as CategoryDetail, D as CertificateVerification, E as CheckoutAddress, F as CheckoutInput, G as CheckoutPaymentMethod, H as CheckoutSettings, I as CookieConsentInput, J as CourseAttachment, K as CourseCertificate, L as CourseComment, M as CourseCommentReply, N as CourseCommentsList, O as CourseDetail, Q as CourseLesson, R as CourseListItem, T as CourseModule, U as CoursePostedComment, V as CourseProgress, W as CourseTutorMessage, X as CourseTutorThread, Y as CrossSellItem, Z as CustomerAddress, _ as CustomerProfile, $ as DigitalDownload, a0 as DownloadUrl, a1 as Facet, a2 as FacetAvailability, a3 as FacetCategory, a4 as FacetLabel, a5 as FacetPriceRange, a6 as FacetRange, a7 as FacetRatingBucket, a8 as FacetValue, a9 as FacetsResponse, aa as FilterField, ab as FulfillmentStatus, ac as FulfillmentStatuses, ad as GiftCardBalance, ae as GiftCardPurchaseInput, af as GiftCardPurchaseResult, ag as GiftCardSummary, ah as LessonNote, ai as LessonQuiz, aj as LoginInput, ak as LoyaltyBalance, al as LoyaltyNextTier, am as LoyaltyProgram, an as LoyaltySummary, ao as LoyaltyTier, ap as LoyaltyTierPerks, aq as LoyaltyTransaction, ar as Menu, as as MenuItem, at as MenuItemRef, au as MenuItemType, av as MessageResponse, aw as NewsletterOptInDefault, ax as NewsletterSubscribeInput, ay as NewsletterSubscribeResult, az as NewsletterUnsubscribeResult, aA as OrderAccessRequestResponse, aB as OrderAccessVerifyResponse, aC as OrderDetail, aD as OrderItem, aE as OrderListItem, aF as OrderStatus, aG as OrderStatusHistory, aH as OrderStatuses, aI as OrderTracking, aJ as Page, aK as PageAttachment, aL as PageDetail, aM as PaginatedResponse, aN as PaymentStatus, aO as PaymentStatuses, aP as PickupPoint, aQ as PickupPointHours, aR as PickupPointsInput, aS as PriceDisplay, aT as ProductAvailability, aU as ProductGroup, aV as ProductLabel, aW as ProductListItem, aX as ProductMedia, aY as ProductMediaVariant, aZ as ProductParameter, a_ as ProductParameterGroup, a$ as ProductParametersResponse, b0 as ProductPrice, b1 as ProductPromotionSummary, b2 as ProductReview, b3 as ProductReviewsResponse, b4 as ProductSort, b5 as ProductSortValue, b6 as ProductVolumePrice, b7 as ProductsQuery, b8 as QuizAnswerInput, b9 as QuizAnswerResult, ba as QuizQuestion, bb as QuizResult, bc as QuoteItem, bd as QuoteRequest, be as RegisterInput, bf as RegisterResult, bg as RequestInterceptor, bh as RequestInterceptorConfig, bi as ResponseInterceptor, bj as ResponseInterceptorData, bk as ReturnRequest, bl as ReturnRequestItem, bm as ReturnStatus, bn as ReturnStatusItem, bo as ReturnableOrder, bp as ReturnableOrderItem, bq as SdkError, br as ShippingMethodSummary, bs as ShippingQuote, bt as ShippingQuoteInput, bu as ShopInfo, bv as ShopScript, bw as ShopScriptPlacement, bx as ShopScriptType, by as ShopScripts, bz as ShopSeo, bA as ShopSeoIdentity, bB as StockBehavior, bC as StockMode, bD as SubmitQuoteInput, bE as SubmitReturnInput, bF as SubmitReviewInput, bG as Subscription, bH as SubscriptionAction, bI as SubscriptionFrequency, bJ as SubscriptionItem, bK as SubscriptionStatus, bL as TaxBreakdownLine, bM as VariantAxis, bN as VariantAxisValue, bO as WishlistItem, bP as err, bQ as ok, bR as toSdkError } from './client-CiowRIBp.mjs';
 
 /**
  * Format a price amount with currency using Intl.NumberFormat.
@@ -11,6 +11,106 @@ export { A as ActivePromotion, a as AddToCartInput, b as AddressDetail, c as Add
  */
 declare function formatPrice(amount: number, currency: string, locale?: string): string;
 
+/**
+ * Variant selection helpers — server-safe (no React, no DOM).
+ *
+ * Every storefront that sells variants needs the same four decisions, and every
+ * one of them has a wrong answer that looks right on screen:
+ *
+ * 1. WHICH variant is selected on first render. It has to be decided on the
+ *    server from `?variant=`, otherwise the page renders the parent's text and
+ *    swaps it after hydration — a visible flash, and the wrong text in view
+ *    source for crawlers.
+ * 2. WHAT the page shows for it. A variant carries its own name, descriptions
+ *    and gallery, but only where the merchant filled them in; everywhere else
+ *    it INHERITS the parent. Rendering the raw variant fields shows empty
+ *    blocks on shops that only translated the name.
+ * 3. WHERE a variant links. A variant has no page of its own, so the link is
+ *    always the parent's slug plus `?variant=` (see `variantHref`).
+ * 4. WHICH variant a click means when there are several axes (colour + size):
+ *    the answer is "the one matching the whole selection", not "the one whose
+ *    label I clicked".
+ */
+
+/** Query parameter carrying the preselected variant. One name, everywhere. */
+declare const VARIANT_QUERY_PARAM = "variant";
+/**
+ * Content actually rendered for a product page: the variant's own values where
+ * it has them, the parent's everywhere else.
+ */
+interface ResolvedVariantContent {
+    name: string;
+    shortDescription: string | null;
+    longDescription: string | null;
+    images: ProductDetail["images"];
+    /** `true` for each field the variant overrode — handy for debugging a shop. */
+    overrides: {
+        name: boolean;
+        shortDescription: boolean;
+        longDescription: boolean;
+        images: boolean;
+    };
+}
+/**
+ * Merge a variant onto its parent product for rendering.
+ *
+ * Pass `variant: null` (nothing selected yet) and you get the parent unchanged,
+ * so a page can call this unconditionally.
+ */
+declare function resolveVariantContent(product: ProductDetail, variant: ProductVariant | null | undefined): ResolvedVariantContent;
+/**
+ * Variant preselected by the URL.
+ *
+ * Accepts whatever the framework hands you (`string`, the array Next.js gives
+ * for repeated params, or nothing) and falls back to `null` when the token
+ * matches no variant — a stale link must render the parent page, never a 404
+ * and never a blank picker.
+ */
+declare function variantFromQuery(product: ProductDetail, value: string | string[] | null | undefined): ProductVariant | null;
+/**
+ * Link to a product, optionally with a variant preselected.
+ *
+ * ALWAYS goes through the parent's slug. Building `/product/${variant.slug}`
+ * is the single most repeated bug around variants: it looks correct, and it
+ * 404s for every visitor, in the cart, in the XML feeds and in the admin's
+ * "open on the web" button — all three of which had exactly that bug.
+ */
+declare function variantHref(productSlug: string, variant?: Pick<ProductVariant, "variantSlug"> | null, basePath?: string): string;
+/**
+ * The variant matching a full axis selection (e.g. `{Barva: "modrá", Velikost:
+ * "M"}`). Returns `null` while the selection is incomplete or names a
+ * combination the merchant never published, which is the moment to disable the
+ * buy button rather than to add "some" variant to the cart.
+ */
+declare function findVariantByAttributes(product: ProductDetail, selection: Record<string, string>): ProductVariant | null;
+/**
+ * Axis values that lead to an existing variant given what is already picked.
+ *
+ * Without this a shop happily offers "modrá + XXL", which no variant covers, and
+ * the customer finds out by clicking. Pass the current partial selection and the
+ * axis being rendered; you get the values worth showing as enabled.
+ */
+declare function availableAxisValues(product: ProductDetail, axisName: string, selection: Record<string, string>): string[];
+/**
+ * Rows for a "compare the editions side by side" table: every axis that
+ * actually differs between variants, plus price and availability.
+ *
+ * Built here rather than in each template because the interesting part is what
+ * to LEAVE OUT: an axis all variants share carries no information and only
+ * makes the table wider.
+ */
+interface VariantComparisonRow {
+    label: string;
+    /** One cell per variant, in `product.variants` order. */
+    values: string[];
+}
+declare function buildVariantComparison(product: ProductDetail, labels: {
+    price: string;
+    availability: string;
+    inStock: string;
+    soldOut: string;
+}, formatPriceValue: (variant: ProductVariant) => string): VariantComparisonRow[];
+
 /**
  * GA4 e-commerce event helper.
  *
@@ -124,4 +224,4 @@ declare function revokeAnalyticsConsent(client: BehioStorefront): Promise<SdkRes
     success: boolean;
 }>>;
 
-export { BehioStorefront, CookieConsent, type EcommerceEventName, type EcommerceItem, type EcommercePayload, SdkResult, formatPrice, generateVisitorId, getStoredVisitorId, grantAnalyticsConsent, revokeAnalyticsConsent, trackEcommerceEvent };
+export { BehioStorefront, CookieConsent, type EcommerceEventName, type EcommerceItem, type EcommercePayload, ProductDetail, ProductVariant, type ResolvedVariantContent, SdkResult, VARIANT_QUERY_PARAM, type VariantComparisonRow, availableAxisValues, buildVariantComparison, findVariantByAttributes, formatPrice, generateVisitorId, getStoredVisitorId, grantAnalyticsConsent, resolveVariantContent, revokeAnalyticsConsent, trackEcommerceEvent, variantFromQuery, variantHref };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { B as BehioStorefront, S as SdkResult, C as CookieConsent } from './client-B0vlHxB1.js';
-export { A as ActivePromotion, a as AddToCartInput, b as AddressDetail, c as AddressSuggestion, d as AddressType, e as AddressTypes, f as AuthTokens, g as BackInStockSubscription, h as BadgeTone, i as BehioApiError, j as BehioErrorCode, k as BehioEventHandler, l as BehioEventType, m as BehioNetworkError, n as BehioStorefrontConfig, o as Bundle, p as BundleItem, q as Cart, r as CartBundleLine, s as CartBundleLineItem, t as CartDiscount, u as CartItem, v as CartItemProduct, w as CartPromotion, x as Category, y as CategoryDetail, z as CertificateVerification, D as CheckoutAddress, E as CheckoutInput, F as CheckoutPaymentMethod, G as CheckoutSettings, H as CookieConsentInput, I as CourseAttachment, J as CourseCertificate, K as CourseComment, L as CourseCommentReply, M as CourseCommentsList, N as CourseDetail, O as CourseLesson, P as CourseListItem, Q as CourseModule, R as CoursePostedComment, T as CourseProgress, U as CourseTutorMessage, V as CourseTutorThread, W as CrossSellItem, X as CustomerAddress, Y as CustomerProfile, Z as DataGroupFieldType, _ as DigitalDownload, $ as DownloadUrl, a0 as Facet, a1 as FacetAvailability, a2 as FacetCategory, a3 as FacetLabel, a4 as FacetPriceRange, a5 as FacetRange, a6 as FacetRatingBucket, a7 as FacetValue, a8 as FacetsResponse, a9 as FilterField, aa as FulfillmentStatus, ab as FulfillmentStatuses, ac as GiftCardBalance, ad as GiftCardPurchaseInput, ae as GiftCardPurchaseResult, af as GiftCardSummary, ag as LessonNote, ah as LessonQuiz, ai as LoginInput, aj as LoyaltyBalance, ak as LoyaltyNextTier, al as LoyaltyProgram, am as LoyaltySummary, an as LoyaltyTier, ao as LoyaltyTierPerks, ap as LoyaltyTransaction, aq as Menu, ar as MenuItem, as as MenuItemRef, at as MenuItemType, au as MessageResponse, av as NewsletterOptInDefault, aw as NewsletterSubscribeInput, ax as NewsletterSubscribeResult, ay as NewsletterUnsubscribeResult, az as OrderAccessRequestResponse, aA as OrderAccessVerifyResponse, aB as OrderDetail, aC as OrderItem, aD as OrderListItem, aE as OrderStatus, aF as OrderStatusHistory, aG as OrderStatuses, aH as OrderTracking, aI as Page, aJ as PageAttachment, aK as PageDetail, aL as PaginatedResponse, aM as PaymentStatus, aN as PaymentStatuses, aO as PickupPoint, aP as PickupPointHours, aQ as PickupPointsInput, aR as PriceDisplay, aS as ProductAvailability, aT as ProductCustomField, aU as ProductCustomFieldGroup, aV as ProductDetail, aW as ProductGroup, aX as ProductLabel, aY as ProductListItem, aZ as ProductMedia, a_ as ProductMediaVariant, a$ as ProductPrice, b0 as ProductPromotionSummary, b1 as ProductReview, b2 as ProductReviewsResponse, b3 as ProductSort, b4 as ProductSortValue, b5 as ProductVariant, b6 as ProductVolumePrice, b7 as ProductsQuery, b8 as QuizAnswerInput, b9 as QuizAnswerResult, ba as QuizQuestion, bb as QuizResult, bc as QuoteItem, bd as QuoteRequest, be as RegisterInput, bf as RegisterResult, bg as RequestInterceptor, bh as RequestInterceptorConfig, bi as ResponseInterceptor, bj as ResponseInterceptorData, bk as ReturnRequest, bl as ReturnRequestItem, bm as ReturnStatus, bn as ReturnStatusItem, bo as ReturnableOrder, bp as ReturnableOrderItem, bq as SdkError, br as ShippingMethodSummary, bs as ShippingQuote, bt as ShippingQuoteInput, bu as ShopInfo, bv as ShopScript, bw as ShopScriptPlacement, bx as ShopScriptType, by as ShopScripts, bz as ShopSeo, bA as ShopSeoIdentity, bB as StockBehavior, bC as StockMode, bD as SubmitQuoteInput, bE as SubmitReturnInput, bF as SubmitReviewInput, bG as Subscription, bH as SubscriptionAction, bI as SubscriptionFrequency, bJ as SubscriptionItem, bK as SubscriptionStatus, bL as TaxBreakdownLine, bM as VariantAxis, bN as VariantAxisValue, bO as WishlistItem, bP as err, bQ as ok, bR as toSdkError } from './client-B0vlHxB1.js';
+import { P as ProductDetail, a as ProductVariant, B as BehioStorefront, S as SdkResult, C as CookieConsent } from './client-CiowRIBp.js';
+export { A as ActivePromotion, b as AddToCartInput, c as AddressDetail, d as AddressSuggestion, e as AddressType, f as AddressTypes, g as AuthTokens, h as BackInStockSubscription, i as BadgeTone, j as BehioApiError, k as BehioErrorCode, l as BehioEventHandler, m as BehioEventType, n as BehioNetworkError, o as BehioStorefrontConfig, p as Bundle, q as BundleItem, r as Cart, s as CartBundleLine, t as CartBundleLineItem, u as CartDiscount, v as CartItem, w as CartItemProduct, x as CartPromotion, y as Category, z as CategoryDetail, D as CertificateVerification, E as CheckoutAddress, F as CheckoutInput, G as CheckoutPaymentMethod, H as CheckoutSettings, I as CookieConsentInput, J as CourseAttachment, K as CourseCertificate, L as CourseComment, M as CourseCommentReply, N as CourseCommentsList, O as CourseDetail, Q as CourseLesson, R as CourseListItem, T as CourseModule, U as CoursePostedComment, V as CourseProgress, W as CourseTutorMessage, X as CourseTutorThread, Y as CrossSellItem, Z as CustomerAddress, _ as CustomerProfile, $ as DigitalDownload, a0 as DownloadUrl, a1 as Facet, a2 as FacetAvailability, a3 as FacetCategory, a4 as FacetLabel, a5 as FacetPriceRange, a6 as FacetRange, a7 as FacetRatingBucket, a8 as FacetValue, a9 as FacetsResponse, aa as FilterField, ab as FulfillmentStatus, ac as FulfillmentStatuses, ad as GiftCardBalance, ae as GiftCardPurchaseInput, af as GiftCardPurchaseResult, ag as GiftCardSummary, ah as LessonNote, ai as LessonQuiz, aj as LoginInput, ak as LoyaltyBalance, al as LoyaltyNextTier, am as LoyaltyProgram, an as LoyaltySummary, ao as LoyaltyTier, ap as LoyaltyTierPerks, aq as LoyaltyTransaction, ar as Menu, as as MenuItem, at as MenuItemRef, au as MenuItemType, av as MessageResponse, aw as NewsletterOptInDefault, ax as NewsletterSubscribeInput, ay as NewsletterSubscribeResult, az as NewsletterUnsubscribeResult, aA as OrderAccessRequestResponse, aB as OrderAccessVerifyResponse, aC as OrderDetail, aD as OrderItem, aE as OrderListItem, aF as OrderStatus, aG as OrderStatusHistory, aH as OrderStatuses, aI as OrderTracking, aJ as Page, aK as PageAttachment, aL as PageDetail, aM as PaginatedResponse, aN as PaymentStatus, aO as PaymentStatuses, aP as PickupPoint, aQ as PickupPointHours, aR as PickupPointsInput, aS as PriceDisplay, aT as ProductAvailability, aU as ProductGroup, aV as ProductLabel, aW as ProductListItem, aX as ProductMedia, aY as ProductMediaVariant, aZ as ProductParameter, a_ as ProductParameterGroup, a$ as ProductParametersResponse, b0 as ProductPrice, b1 as ProductPromotionSummary, b2 as ProductReview, b3 as ProductReviewsResponse, b4 as ProductSort, b5 as ProductSortValue, b6 as ProductVolumePrice, b7 as ProductsQuery, b8 as QuizAnswerInput, b9 as QuizAnswerResult, ba as QuizQuestion, bb as QuizResult, bc as QuoteItem, bd as QuoteRequest, be as RegisterInput, bf as RegisterResult, bg as RequestInterceptor, bh as RequestInterceptorConfig, bi as ResponseInterceptor, bj as ResponseInterceptorData, bk as ReturnRequest, bl as ReturnRequestItem, bm as ReturnStatus, bn as ReturnStatusItem, bo as ReturnableOrder, bp as ReturnableOrderItem, bq as SdkError, br as ShippingMethodSummary, bs as ShippingQuote, bt as ShippingQuoteInput, bu as ShopInfo, bv as ShopScript, bw as ShopScriptPlacement, bx as ShopScriptType, by as ShopScripts, bz as ShopSeo, bA as ShopSeoIdentity, bB as StockBehavior, bC as StockMode, bD as SubmitQuoteInput, bE as SubmitReturnInput, bF as SubmitReviewInput, bG as Subscription, bH as SubscriptionAction, bI as SubscriptionFrequency, bJ as SubscriptionItem, bK as SubscriptionStatus, bL as TaxBreakdownLine, bM as VariantAxis, bN as VariantAxisValue, bO as WishlistItem, bP as err, bQ as ok, bR as toSdkError } from './client-CiowRIBp.js';
 
 /**
  * Format a price amount with currency using Intl.NumberFormat.
@@ -11,6 +11,106 @@ export { A as ActivePromotion, a as AddToCartInput, b as AddressDetail, c as Add
  */
 declare function formatPrice(amount: number, currency: string, locale?: string): string;
 
+/**
+ * Variant selection helpers — server-safe (no React, no DOM).
+ *
+ * Every storefront that sells variants needs the same four decisions, and every
+ * one of them has a wrong answer that looks right on screen:
+ *
+ * 1. WHICH variant is selected on first render. It has to be decided on the
+ *    server from `?variant=`, otherwise the page renders the parent's text and
+ *    swaps it after hydration — a visible flash, and the wrong text in view
+ *    source for crawlers.
+ * 2. WHAT the page shows for it. A variant carries its own name, descriptions
+ *    and gallery, but only where the merchant filled them in; everywhere else
+ *    it INHERITS the parent. Rendering the raw variant fields shows empty
+ *    blocks on shops that only translated the name.
+ * 3. WHERE a variant links. A variant has no page of its own, so the link is
+ *    always the parent's slug plus `?variant=` (see `variantHref`).
+ * 4. WHICH variant a click means when there are several axes (colour + size):
+ *    the answer is "the one matching the whole selection", not "the one whose
+ *    label I clicked".
+ */
+
+/** Query parameter carrying the preselected variant. One name, everywhere. */
+declare const VARIANT_QUERY_PARAM = "variant";
+/**
+ * Content actually rendered for a product page: the variant's own values where
+ * it has them, the parent's everywhere else.
+ */
+interface ResolvedVariantContent {
+    name: string;
+    shortDescription: string | null;
+    longDescription: string | null;
+    images: ProductDetail["images"];
+    /** `true` for each field the variant overrode — handy for debugging a shop. */
+    overrides: {
+        name: boolean;
+        shortDescription: boolean;
+        longDescription: boolean;
+        images: boolean;
+    };
+}
+/**
+ * Merge a variant onto its parent product for rendering.
+ *
+ * Pass `variant: null` (nothing selected yet) and you get the parent unchanged,
+ * so a page can call this unconditionally.
+ */
+declare function resolveVariantContent(product: ProductDetail, variant: ProductVariant | null | undefined): ResolvedVariantContent;
+/**
+ * Variant preselected by the URL.
+ *
+ * Accepts whatever the framework hands you (`string`, the array Next.js gives
+ * for repeated params, or nothing) and falls back to `null` when the token
+ * matches no variant — a stale link must render the parent page, never a 404
+ * and never a blank picker.
+ */
+declare function variantFromQuery(product: ProductDetail, value: string | string[] | null | undefined): ProductVariant | null;
+/**
+ * Link to a product, optionally with a variant preselected.
+ *
+ * ALWAYS goes through the parent's slug. Building `/product/${variant.slug}`
+ * is the single most repeated bug around variants: it looks correct, and it
+ * 404s for every visitor, in the cart, in the XML feeds and in the admin's
+ * "open on the web" button — all three of which had exactly that bug.
+ */
+declare function variantHref(productSlug: string, variant?: Pick<ProductVariant, "variantSlug"> | null, basePath?: string): string;
+/**
+ * The variant matching a full axis selection (e.g. `{Barva: "modrá", Velikost:
+ * "M"}`). Returns `null` while the selection is incomplete or names a
+ * combination the merchant never published, which is the moment to disable the
+ * buy button rather than to add "some" variant to the cart.
+ */
+declare function findVariantByAttributes(product: ProductDetail, selection: Record<string, string>): ProductVariant | null;
+/**
+ * Axis values that lead to an existing variant given what is already picked.
+ *
+ * Without this a shop happily offers "modrá + XXL", which no variant covers, and
+ * the customer finds out by clicking. Pass the current partial selection and the
+ * axis being rendered; you get the values worth showing as enabled.
+ */
+declare function availableAxisValues(product: ProductDetail, axisName: string, selection: Record<string, string>): string[];
+/**
+ * Rows for a "compare the editions side by side" table: every axis that
+ * actually differs between variants, plus price and availability.
+ *
+ * Built here rather than in each template because the interesting part is what
+ * to LEAVE OUT: an axis all variants share carries no information and only
+ * makes the table wider.
+ */
+interface VariantComparisonRow {
+    label: string;
+    /** One cell per variant, in `product.variants` order. */
+    values: string[];
+}
+declare function buildVariantComparison(product: ProductDetail, labels: {
+    price: string;
+    availability: string;
+    inStock: string;
+    soldOut: string;
+}, formatPriceValue: (variant: ProductVariant) => string): VariantComparisonRow[];
+
 /**
  * GA4 e-commerce event helper.
  *
@@ -124,4 +224,4 @@ declare function revokeAnalyticsConsent(client: BehioStorefront): Promise<SdkRes
     success: boolean;
 }>>;
 
-export { BehioStorefront, CookieConsent, type EcommerceEventName, type EcommerceItem, type EcommercePayload, SdkResult, formatPrice, generateVisitorId, getStoredVisitorId, grantAnalyticsConsent, revokeAnalyticsConsent, trackEcommerceEvent };
+export { BehioStorefront, CookieConsent, type EcommerceEventName, type EcommerceItem, type EcommercePayload, ProductDetail, ProductVariant, type ResolvedVariantContent, SdkResult, VARIANT_QUERY_PARAM, type VariantComparisonRow, availableAxisValues, buildVariantComparison, findVariantByAttributes, formatPrice, generateVisitorId, getStoredVisitorId, grantAnalyticsConsent, resolveVariantContent, revokeAnalyticsConsent, trackEcommerceEvent, variantFromQuery, variantHref };