@behio/storefront-sdk 1.0.0 → 1.2.0

package/dist/{client-BKNtLTcu.d.mts → client-BU8Kfb74.d.mts}

@@ -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
@@ -513,6 +561,25 @@ interface VariantAxisValue {
  * configured the axis (the storefront's historical default). Join to
  * `variants[].attributes` by axis `name` + `value`.
  */
+/**
+ * Sourozenecká karta při rozpadu katalogu podle osy (typicky barvy).
+ *
+ * Každá barva je samostatný produkt s vlastní adresou, fotkami a SEO, takže
+ * kolečka barev se vykreslují jako odkazy (`<a href>`), ne jako přepínač uvnitř
+ * stránky. Bez odkazu by je nešlo indexovat a nefungovaly by bez JavaScriptu.
+ */
+interface ProductSibling {
+    productId: string;
+    /** Adresa karty; skládá se s cestou produktu ve storefrontu. */
+    slug: string;
+    name: string;
+    /** Hodnota osy ("Růžová"); null u hlavního produktu skupiny. */
+    axisValue: string | null;
+    swatchColor: string | null;
+    swatchImage: string | null;
+    /** Tahle karta je právě otevřená stránka. */
+    isCurrent: boolean;
+}
 interface VariantAxis {
     name: string;
     displayType: "DROPDOWN" | "BUTTON" | "SWATCH_COLOR" | "SWATCH_IMAGE";
@@ -583,6 +650,11 @@ interface ProductDetail extends ProductListItem {
      * Empty when the product has no variants.
      */
     variantAxes: VariantAxis[];
+    /**
+     * Sourozenecké karty při rozpadu podle osy. Prázdné u e-shopu, který rozpad
+     * nepoužívá, tedy ve výchozím nastavení.
+     */
+    catalogSiblings: ProductSibling[];
     volumePricing: ProductVolumePrice[];
     /**
      * Curated parameter groups, already resolved. Empty when the merchant
@@ -892,7 +964,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;
@@ -2870,4 +2957,4 @@ declare class NewsletterModule {
     unsubscribe(email: string): Promise<SdkResult<NewsletterUnsubscribeResult>>;
 }
 
-export { type Facet 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 DigitalDownload as Z, type DownloadUrl as _, type AddToCartInput as a, type ProductPrice as a$, type FacetAvailability as a0, type FacetCategory as a1, type FacetLabel as a2, type FacetPriceRange as a3, type FacetRange as a4, type FacetRatingBucket as a5, type FacetValue as a6, type FacetsResponse as a7, type FilterField as a8, type FulfillmentStatus as a9, type OrderDetail as aA, type OrderItem as aB, type OrderListItem as aC, type OrderStatus as aD, type OrderStatusHistory as aE, OrderStatuses as aF, type OrderTracking as aG, type Page as aH, type PageAttachment as aI, type PageDetail as aJ, type PaginatedResponse as aK, type PaymentStatus as aL, PaymentStatuses as aM, type PickupPoint as aN, type PickupPointHours as aO, type PickupPointsInput as aP, type PriceDisplay as aQ, type ProductAvailability as aR, type ProductDetail as aS, type ProductGroup as aT, type ProductLabel as aU, type ProductListItem as aV, type ProductMedia as aW, type ProductMediaVariant as aX, type ProductParameter as aY, type ProductParameterGroup as aZ, type ProductParametersResponse as a_, FulfillmentStatuses as aa, type GiftCardBalance as ab, type GiftCardPurchaseInput as ac, type GiftCardPurchaseResult as ad, type GiftCardSummary as ae, type LessonNote as af, type LessonQuiz as ag, type LoginInput as ah, type LoyaltyBalance as ai, type LoyaltyNextTier as aj, type LoyaltyProgram as ak, type LoyaltySummary as al, type LoyaltyTier as am, type LoyaltyTierPerks as an, type LoyaltyTransaction as ao, type Menu as ap, type MenuItem as aq, type MenuItemRef as ar, type MenuItemType as as, type MessageResponse as at, type NewsletterOptInDefault as au, type NewsletterSubscribeInput as av, type NewsletterSubscribeResult as aw, type NewsletterUnsubscribeResult as ax, type OrderAccessRequestResponse as ay, type OrderAccessVerifyResponse 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, type ProductSibling as b4, ProductSort as b5, type ProductSortValue as b6, type ProductVolumePrice as b7, type ProductsQuery as b8, type QuizAnswerInput as b9, type ShopSeo as bA, type ShopSeoIdentity as bB, type StockBehavior as bC, type StockMode as bD, type SubmitQuoteInput as bE, type SubmitReturnInput as bF, type SubmitReviewInput as bG, type Subscription as bH, type SubscriptionAction as bI, type SubscriptionFrequency as bJ, type SubscriptionItem as bK, type SubscriptionStatus as bL, type TaxBreakdownLine as bM, type VariantAxis as bN, type VariantAxisValue as bO, type WishlistItem as bP, err as bQ, ok as bR, toSdkError as bS, type QuizAnswerResult as ba, type QuizQuestion as bb, type QuizResult as bc, type QuoteItem as bd, type QuoteRequest as be, type RegisterInput as bf, type RegisterResult as bg, type RequestInterceptor as bh, type RequestInterceptorConfig as bi, type ResponseInterceptor as bj, type ResponseInterceptorData as bk, type ReturnRequest as bl, type ReturnRequestItem as bm, type ReturnStatus as bn, type ReturnStatusItem as bo, type ReturnableOrder as bp, type ReturnableOrderItem as bq, type SdkError as br, type ShippingMethodSummary as bs, type ShippingQuote as bt, type ShippingQuoteInput as bu, type ShopInfo as bv, type ShopScript as bw, type ShopScriptPlacement as bx, type ShopScriptType as by, type ShopScripts 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/{client-BKNtLTcu.d.ts → client-BU8Kfb74.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
@@ -513,6 +561,25 @@ interface VariantAxisValue {
  * configured the axis (the storefront's historical default). Join to
  * `variants[].attributes` by axis `name` + `value`.
  */
+/**
+ * Sourozenecká karta při rozpadu katalogu podle osy (typicky barvy).
+ *
+ * Každá barva je samostatný produkt s vlastní adresou, fotkami a SEO, takže
+ * kolečka barev se vykreslují jako odkazy (`<a href>`), ne jako přepínač uvnitř
+ * stránky. Bez odkazu by je nešlo indexovat a nefungovaly by bez JavaScriptu.
+ */
+interface ProductSibling {
+    productId: string;
+    /** Adresa karty; skládá se s cestou produktu ve storefrontu. */
+    slug: string;
+    name: string;
+    /** Hodnota osy ("Růžová"); null u hlavního produktu skupiny. */
+    axisValue: string | null;
+    swatchColor: string | null;
+    swatchImage: string | null;
+    /** Tahle karta je právě otevřená stránka. */
+    isCurrent: boolean;
+}
 interface VariantAxis {
     name: string;
     displayType: "DROPDOWN" | "BUTTON" | "SWATCH_COLOR" | "SWATCH_IMAGE";
@@ -583,6 +650,11 @@ interface ProductDetail extends ProductListItem {
      * Empty when the product has no variants.
      */
     variantAxes: VariantAxis[];
+    /**
+     * Sourozenecké karty při rozpadu podle osy. Prázdné u e-shopu, který rozpad
+     * nepoužívá, tedy ve výchozím nastavení.
+     */
+    catalogSiblings: ProductSibling[];
     volumePricing: ProductVolumePrice[];
     /**
      * Curated parameter groups, already resolved. Empty when the merchant
@@ -892,7 +964,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;
@@ -2870,4 +2957,4 @@ declare class NewsletterModule {
     unsubscribe(email: string): Promise<SdkResult<NewsletterUnsubscribeResult>>;
 }
 
-export { type Facet 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 DigitalDownload as Z, type DownloadUrl as _, type AddToCartInput as a, type ProductPrice as a$, type FacetAvailability as a0, type FacetCategory as a1, type FacetLabel as a2, type FacetPriceRange as a3, type FacetRange as a4, type FacetRatingBucket as a5, type FacetValue as a6, type FacetsResponse as a7, type FilterField as a8, type FulfillmentStatus as a9, type OrderDetail as aA, type OrderItem as aB, type OrderListItem as aC, type OrderStatus as aD, type OrderStatusHistory as aE, OrderStatuses as aF, type OrderTracking as aG, type Page as aH, type PageAttachment as aI, type PageDetail as aJ, type PaginatedResponse as aK, type PaymentStatus as aL, PaymentStatuses as aM, type PickupPoint as aN, type PickupPointHours as aO, type PickupPointsInput as aP, type PriceDisplay as aQ, type ProductAvailability as aR, type ProductDetail as aS, type ProductGroup as aT, type ProductLabel as aU, type ProductListItem as aV, type ProductMedia as aW, type ProductMediaVariant as aX, type ProductParameter as aY, type ProductParameterGroup as aZ, type ProductParametersResponse as a_, FulfillmentStatuses as aa, type GiftCardBalance as ab, type GiftCardPurchaseInput as ac, type GiftCardPurchaseResult as ad, type GiftCardSummary as ae, type LessonNote as af, type LessonQuiz as ag, type LoginInput as ah, type LoyaltyBalance as ai, type LoyaltyNextTier as aj, type LoyaltyProgram as ak, type LoyaltySummary as al, type LoyaltyTier as am, type LoyaltyTierPerks as an, type LoyaltyTransaction as ao, type Menu as ap, type MenuItem as aq, type MenuItemRef as ar, type MenuItemType as as, type MessageResponse as at, type NewsletterOptInDefault as au, type NewsletterSubscribeInput as av, type NewsletterSubscribeResult as aw, type NewsletterUnsubscribeResult as ax, type OrderAccessRequestResponse as ay, type OrderAccessVerifyResponse 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, type ProductSibling as b4, ProductSort as b5, type ProductSortValue as b6, type ProductVolumePrice as b7, type ProductsQuery as b8, type QuizAnswerInput as b9, type ShopSeo as bA, type ShopSeoIdentity as bB, type StockBehavior as bC, type StockMode as bD, type SubmitQuoteInput as bE, type SubmitReturnInput as bF, type SubmitReviewInput as bG, type Subscription as bH, type SubscriptionAction as bI, type SubscriptionFrequency as bJ, type SubscriptionItem as bK, type SubscriptionStatus as bL, type TaxBreakdownLine as bM, type VariantAxis as bN, type VariantAxisValue as bO, type WishlistItem as bP, err as bQ, ok as bR, toSdkError as bS, type QuizAnswerResult as ba, type QuizQuestion as bb, type QuizResult as bc, type QuoteItem as bd, type QuoteRequest as be, type RegisterInput as bf, type RegisterResult as bg, type RequestInterceptor as bh, type RequestInterceptorConfig as bi, type ResponseInterceptor as bj, type ResponseInterceptorData as bk, type ReturnRequest as bl, type ReturnRequestItem as bm, type ReturnStatus as bn, type ReturnStatusItem as bo, type ReturnableOrder as bp, type ReturnableOrderItem as bq, type SdkError as br, type ShippingMethodSummary as bs, type ShippingQuote as bt, type ShippingQuoteInput as bu, type ShopInfo as bv, type ShopScript as bw, type ShopScriptPlacement as bx, type ShopScriptType as by, type ShopScripts 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-BKNtLTcu.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 DigitalDownload, _ as DownloadUrl, $ as Facet, a0 as FacetAvailability, a1 as FacetCategory, a2 as FacetLabel, a3 as FacetPriceRange, a4 as FacetRange, a5 as FacetRatingBucket, a6 as FacetValue, a7 as FacetsResponse, a8 as FilterField, a9 as FulfillmentStatus, aa as FulfillmentStatuses, ab as GiftCardBalance, ac as GiftCardPurchaseInput, ad as GiftCardPurchaseResult, ae as GiftCardSummary, af as LessonNote, ag as LessonQuiz, ah as LoginInput, ai as LoyaltyBalance, aj as LoyaltyNextTier, ak as LoyaltyProgram, al as LoyaltySummary, am as LoyaltyTier, an as LoyaltyTierPerks, ao as LoyaltyTransaction, ap as Menu, aq as MenuItem, ar as MenuItemRef, as as MenuItemType, at as MessageResponse, au as NewsletterOptInDefault, av as NewsletterSubscribeInput, aw as NewsletterSubscribeResult, ax as NewsletterUnsubscribeResult, ay as OrderAccessRequestResponse, az as OrderAccessVerifyResponse, aA as OrderDetail, aB as OrderItem, aC as OrderListItem, aD as OrderStatus, aE as OrderStatusHistory, aF as OrderStatuses, aG as OrderTracking, aH as Page, aI as PageAttachment, aJ as PageDetail, aK as PaginatedResponse, aL as PaymentStatus, aM as PaymentStatuses, aN as PickupPoint, aO as PickupPointHours, aP as PickupPointsInput, aQ as PriceDisplay, aR as ProductAvailability, aS as ProductDetail, aT as ProductGroup, aU as ProductLabel, aV as ProductListItem, aW as ProductMedia, aX as ProductMediaVariant, aY as ProductParameter, aZ as ProductParameterGroup, a_ as ProductParametersResponse, 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-BKNtLTcu.mjs';
+import { P as ProductDetail, a as ProductVariant, B as BehioStorefront, S as SdkResult, C as CookieConsent } from './client-BU8Kfb74.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 ProductSibling, b5 as ProductSort, b6 as ProductSortValue, b7 as ProductVolumePrice, b8 as ProductsQuery, b9 as QuizAnswerInput, ba as QuizAnswerResult, bb as QuizQuestion, bc as QuizResult, bd as QuoteItem, be as QuoteRequest, bf as RegisterInput, bg as RegisterResult, bh as RequestInterceptor, bi as RequestInterceptorConfig, bj as ResponseInterceptor, bk as ResponseInterceptorData, bl as ReturnRequest, bm as ReturnRequestItem, bn as ReturnStatus, bo as ReturnStatusItem, bp as ReturnableOrder, bq as ReturnableOrderItem, br as SdkError, bs as ShippingMethodSummary, bt as ShippingQuote, bu as ShippingQuoteInput, bv as ShopInfo, bw as ShopScript, bx as ShopScriptPlacement, by as ShopScriptType, bz as ShopScripts, bA as ShopSeo, bB as ShopSeoIdentity, bC as StockBehavior, bD as StockMode, bE as SubmitQuoteInput, bF as SubmitReturnInput, bG as SubmitReviewInput, bH as Subscription, bI as SubscriptionAction, bJ as SubscriptionFrequency, bK as SubscriptionItem, bL as SubscriptionStatus, bM as TaxBreakdownLine, bN as VariantAxis, bO as VariantAxisValue, bP as WishlistItem, bQ as err, bR as ok, bS as toSdkError } from './client-BU8Kfb74.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-BKNtLTcu.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 DigitalDownload, _ as DownloadUrl, $ as Facet, a0 as FacetAvailability, a1 as FacetCategory, a2 as FacetLabel, a3 as FacetPriceRange, a4 as FacetRange, a5 as FacetRatingBucket, a6 as FacetValue, a7 as FacetsResponse, a8 as FilterField, a9 as FulfillmentStatus, aa as FulfillmentStatuses, ab as GiftCardBalance, ac as GiftCardPurchaseInput, ad as GiftCardPurchaseResult, ae as GiftCardSummary, af as LessonNote, ag as LessonQuiz, ah as LoginInput, ai as LoyaltyBalance, aj as LoyaltyNextTier, ak as LoyaltyProgram, al as LoyaltySummary, am as LoyaltyTier, an as LoyaltyTierPerks, ao as LoyaltyTransaction, ap as Menu, aq as MenuItem, ar as MenuItemRef, as as MenuItemType, at as MessageResponse, au as NewsletterOptInDefault, av as NewsletterSubscribeInput, aw as NewsletterSubscribeResult, ax as NewsletterUnsubscribeResult, ay as OrderAccessRequestResponse, az as OrderAccessVerifyResponse, aA as OrderDetail, aB as OrderItem, aC as OrderListItem, aD as OrderStatus, aE as OrderStatusHistory, aF as OrderStatuses, aG as OrderTracking, aH as Page, aI as PageAttachment, aJ as PageDetail, aK as PaginatedResponse, aL as PaymentStatus, aM as PaymentStatuses, aN as PickupPoint, aO as PickupPointHours, aP as PickupPointsInput, aQ as PriceDisplay, aR as ProductAvailability, aS as ProductDetail, aT as ProductGroup, aU as ProductLabel, aV as ProductListItem, aW as ProductMedia, aX as ProductMediaVariant, aY as ProductParameter, aZ as ProductParameterGroup, a_ as ProductParametersResponse, 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-BKNtLTcu.js';
+import { P as ProductDetail, a as ProductVariant, B as BehioStorefront, S as SdkResult, C as CookieConsent } from './client-BU8Kfb74.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 ProductSibling, b5 as ProductSort, b6 as ProductSortValue, b7 as ProductVolumePrice, b8 as ProductsQuery, b9 as QuizAnswerInput, ba as QuizAnswerResult, bb as QuizQuestion, bc as QuizResult, bd as QuoteItem, be as QuoteRequest, bf as RegisterInput, bg as RegisterResult, bh as RequestInterceptor, bi as RequestInterceptorConfig, bj as ResponseInterceptor, bk as ResponseInterceptorData, bl as ReturnRequest, bm as ReturnRequestItem, bn as ReturnStatus, bo as ReturnStatusItem, bp as ReturnableOrder, bq as ReturnableOrderItem, br as SdkError, bs as ShippingMethodSummary, bt as ShippingQuote, bu as ShippingQuoteInput, bv as ShopInfo, bw as ShopScript, bx as ShopScriptPlacement, by as ShopScriptType, bz as ShopScripts, bA as ShopSeo, bB as ShopSeoIdentity, bC as StockBehavior, bD as StockMode, bE as SubmitQuoteInput, bF as SubmitReturnInput, bG as SubmitReviewInput, bH as Subscription, bI as SubscriptionAction, bJ as SubscriptionFrequency, bK as SubscriptionItem, bL as SubscriptionStatus, bM as TaxBreakdownLine, bN as VariantAxis, bO as VariantAxisValue, bP as WishlistItem, bQ as err, bR as ok, bS as toSdkError } from './client-BU8Kfb74.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 };

package/dist/index.js

@@ -27,6 +27,103 @@ function formatPrice(amount, currency, locale) {
   }
 }
 
+// src/variants.ts
+var VARIANT_QUERY_PARAM = "variant";
+var filled = (value) => {
+  const trimmed = _optionalChain([value, 'optionalAccess', _ => _.trim, 'call', _2 => _2()]);
+  return trimmed ? trimmed : null;
+};
+function resolveVariantContent(product, variant) {
+  const name = filled(_optionalChain([variant, 'optionalAccess', _3 => _3.name]));
+  const short = filled(_optionalChain([variant, 'optionalAccess', _4 => _4.shortDescription]));
+  const long = filled(_optionalChain([variant, 'optionalAccess', _5 => _5.longDescription]));
+  const images = _optionalChain([variant, 'optionalAccess', _6 => _6.images, 'optionalAccess', _7 => _7.length]) ? variant.images : null;
+  return {
+    name: _nullishCoalesce(name, () => ( product.name)),
+    shortDescription: _nullishCoalesce(_nullishCoalesce(short, () => ( product.shortDescription)), () => ( null)),
+    longDescription: _nullishCoalesce(_nullishCoalesce(long, () => ( product.longDescription)), () => ( null)),
+    images: _nullishCoalesce(images, () => ( product.images)),
+    overrides: {
+      name: !!name && name !== product.name,
+      shortDescription: !!short,
+      longDescription: !!long,
+      images: !!images
+    }
+  };
+}
+function variantFromQuery(product, value) {
+  const token = Array.isArray(value) ? value[0] : value;
+  if (!token) return null;
+  return _nullishCoalesce(product.variants.find((v) => v.variantSlug === token || v.id === token), () => ( null));
+}
+function variantHref(productSlug, variant, basePath = "/product") {
+  const base = `${basePath}/${productSlug}`;
+  if (!_optionalChain([variant, 'optionalAccess', _8 => _8.variantSlug])) return base;
+  return `${base}?${VARIANT_QUERY_PARAM}=${encodeURIComponent(variant.variantSlug)}`;
+}
+function findVariantByAttributes(product, selection) {
+  const axes = Object.keys(selection);
+  if (axes.length === 0) return null;
+  return _nullishCoalesce(product.variants.find(
+    (variant) => axes.every((axis) => variant.attributes.some((a) => a.name === axis && a.value === selection[axis]))
+  ), () => ( null));
+}
+function availableAxisValues(product, axisName, selection) {
+  const others = Object.entries(selection).filter(([name]) => name !== axisName);
+  const values = /* @__PURE__ */ new Set();
+  for (const variant of product.variants) {
+    const matchesOthers = others.every(
+      ([name, value]) => variant.attributes.some((a) => a.name === name && a.value === value)
+    );
+    if (!matchesOthers) continue;
+    const own = variant.attributes.find((a) => a.name === axisName);
+    if (own) values.add(own.value);
+  }
+  return [...values];
+}
+function buildVariantComparison(product, labels, formatPriceValue) {
+  const rows = [];
+  const axisNames = /* @__PURE__ */ new Set();
+  for (const variant of product.variants) {
+    for (const attribute of variant.attributes) axisNames.add(attribute.name);
+  }
+  for (const axis of axisNames) {
+    const values = product.variants.map(
+      (v) => _nullishCoalesce(_optionalChain([v, 'access', _9 => _9.attributes, 'access', _10 => _10.find, 'call', _11 => _11((a) => a.name === axis), 'optionalAccess', _12 => _12.value]), () => ( "-"))
+    );
+    if (new Set(values).size <= 1) continue;
+    rows.push({ label: axis, values });
+  }
+  rows.push({
+    label: labels.price,
+    values: product.variants.map((v) => formatPriceValue(v))
+  });
+  rows.push({
+    label: labels.availability,
+    values: product.variants.map((v) => v.inStock ? labels.inStock : labels.soldOut)
+  });
+  const parameterLabels = /* @__PURE__ */ new Set();
+  for (const variant of product.variants) {
+    for (const group of _nullishCoalesce(variant.parameterGroups, () => ( []))) {
+      for (const parameter of _nullishCoalesce(group.parameters, () => ( []))) parameterLabels.add(parameter.label);
+    }
+  }
+  for (const label of parameterLabels) {
+    const values = product.variants.map((variant) => {
+      for (const group of _nullishCoalesce(variant.parameterGroups, () => ( []))) {
+        const hit = _optionalChain([group, 'access', _13 => _13.parameters, 'optionalAccess', _14 => _14.find, 'call', _15 => _15((p) => p.label === label)]);
+        if (!hit) continue;
+        if (hit.value) return [hit.value, hit.unit].filter(Boolean).join(" ");
+        if (hit.booleanValue !== null) return hit.booleanValue ? "\u2713" : "-";
+      }
+      return "-";
+    });
+    if (new Set(values).size <= 1) continue;
+    rows.push({ label, values });
+  }
+  return rows;
+}
+
 // src/analytics.ts
 var GA4_NAME_MAP = {
   newsletter_signup: "generate_lead"
@@ -35,7 +132,7 @@ function trackEcommerceEvent(event, payload) {
   if (typeof window === "undefined") return;
   const w = window;
   try {
-    _optionalChain([w, 'access', _ => _.__behioEcommerceSink, 'optionalCall', _2 => _2(event, payload)]);
+    _optionalChain([w, 'access', _16 => _16.__behioEcommerceSink, 'optionalCall', _17 => _17(event, payload)]);
   } catch (e2) {
   }
   const gaName = _nullishCoalesce(GA4_NAME_MAP[event], () => ( event));
@@ -67,12 +164,12 @@ function getStoredVisitorId() {
 function generateVisitorId() {
   const bytes = new Uint8Array(18);
   try {
-    _optionalChain([globalThis, 'access', _3 => _3.crypto, 'optionalAccess', _4 => _4.getRandomValues, 'optionalCall', _5 => _5(bytes)]);
+    _optionalChain([globalThis, 'access', _18 => _18.crypto, 'optionalAccess', _19 => _19.getRandomValues, 'optionalCall', _20 => _20(bytes)]);
   } catch (e5) {
   }
-  let filled = false;
-  for (const b of bytes) if (b !== 0) filled = true;
-  if (!filled) for (let i = 0; i < bytes.length; i++) bytes[i] = Math.floor(Math.random() * 256);
+  let filled2 = false;
+  for (const b of bytes) if (b !== 0) filled2 = true;
+  if (!filled2) for (let i = 0; i < bytes.length; i++) bytes[i] = Math.floor(Math.random() * 256);
   let bin = "";
   for (const b of bytes) bin += String.fromCharCode(b);
   const b64 = typeof btoa === "function" ? btoa(bin) : Buffer.from(bytes).toString("base64");
@@ -108,8 +205,8 @@ async function grantAnalyticsConsent(client, categories) {
   const res = await client.consent.record({
     visitorId: id,
     analytics: true,
-    marketing: _nullishCoalesce(_optionalChain([categories, 'optionalAccess', _6 => _6.marketing]), () => ( false)),
-    preferences: _nullishCoalesce(_optionalChain([categories, 'optionalAccess', _7 => _7.preferences]), () => ( false))
+    marketing: _nullishCoalesce(_optionalChain([categories, 'optionalAccess', _21 => _21.marketing]), () => ( false)),
+    preferences: _nullishCoalesce(_optionalChain([categories, 'optionalAccess', _22 => _22.preferences]), () => ( false))
   });
   emitConsentChanged();
   return res;
@@ -139,4 +236,11 @@ async function revokeAnalyticsConsent(client) {
 
 
 
-exports.AddressTypes = _chunkODAMBLGYjs.AddressTypes; exports.BehioApiError = _chunkODAMBLGYjs.BehioApiError; exports.BehioNetworkError = _chunkODAMBLGYjs.BehioNetworkError; exports.BehioStorefront = _chunkODAMBLGYjs.BehioStorefront; exports.FulfillmentStatuses = _chunkODAMBLGYjs.FulfillmentStatuses; exports.OrderStatuses = _chunkODAMBLGYjs.OrderStatuses; exports.PaymentStatuses = _chunkODAMBLGYjs.PaymentStatuses; exports.ProductSort = _chunkODAMBLGYjs.ProductSort; exports.err = _chunkODAMBLGYjs.err; exports.formatPrice = formatPrice; exports.generateVisitorId = generateVisitorId; exports.getStoredVisitorId = getStoredVisitorId; exports.grantAnalyticsConsent = grantAnalyticsConsent; exports.ok = _chunkODAMBLGYjs.ok; exports.revokeAnalyticsConsent = revokeAnalyticsConsent; exports.toSdkError = _chunkODAMBLGYjs.toSdkError; exports.trackEcommerceEvent = trackEcommerceEvent;
+
+
+
+
+
+
+
+exports.AddressTypes = _chunkODAMBLGYjs.AddressTypes; exports.BehioApiError = _chunkODAMBLGYjs.BehioApiError; exports.BehioNetworkError = _chunkODAMBLGYjs.BehioNetworkError; exports.BehioStorefront = _chunkODAMBLGYjs.BehioStorefront; exports.FulfillmentStatuses = _chunkODAMBLGYjs.FulfillmentStatuses; exports.OrderStatuses = _chunkODAMBLGYjs.OrderStatuses; exports.PaymentStatuses = _chunkODAMBLGYjs.PaymentStatuses; exports.ProductSort = _chunkODAMBLGYjs.ProductSort; exports.VARIANT_QUERY_PARAM = VARIANT_QUERY_PARAM; exports.availableAxisValues = availableAxisValues; exports.buildVariantComparison = buildVariantComparison; exports.err = _chunkODAMBLGYjs.err; exports.findVariantByAttributes = findVariantByAttributes; exports.formatPrice = formatPrice; exports.generateVisitorId = generateVisitorId; exports.getStoredVisitorId = getStoredVisitorId; exports.grantAnalyticsConsent = grantAnalyticsConsent; exports.ok = _chunkODAMBLGYjs.ok; exports.resolveVariantContent = resolveVariantContent; exports.revokeAnalyticsConsent = revokeAnalyticsConsent; exports.toSdkError = _chunkODAMBLGYjs.toSdkError; exports.trackEcommerceEvent = trackEcommerceEvent; exports.variantFromQuery = variantFromQuery; exports.variantHref = variantHref;

package/dist/index.mjs

@@ -27,6 +27,103 @@ function formatPrice(amount, currency, locale) {
   }
 }
 
+// src/variants.ts
+var VARIANT_QUERY_PARAM = "variant";
+var filled = (value) => {
+  const trimmed = value?.trim();
+  return trimmed ? trimmed : null;
+};
+function resolveVariantContent(product, variant) {
+  const name = filled(variant?.name);
+  const short = filled(variant?.shortDescription);
+  const long = filled(variant?.longDescription);
+  const images = variant?.images?.length ? variant.images : null;
+  return {
+    name: name ?? product.name,
+    shortDescription: short ?? product.shortDescription ?? null,
+    longDescription: long ?? product.longDescription ?? null,
+    images: images ?? product.images,
+    overrides: {
+      name: !!name && name !== product.name,
+      shortDescription: !!short,
+      longDescription: !!long,
+      images: !!images
+    }
+  };
+}
+function variantFromQuery(product, value) {
+  const token = Array.isArray(value) ? value[0] : value;
+  if (!token) return null;
+  return product.variants.find((v) => v.variantSlug === token || v.id === token) ?? null;
+}
+function variantHref(productSlug, variant, basePath = "/product") {
+  const base = `${basePath}/${productSlug}`;
+  if (!variant?.variantSlug) return base;
+  return `${base}?${VARIANT_QUERY_PARAM}=${encodeURIComponent(variant.variantSlug)}`;
+}
+function findVariantByAttributes(product, selection) {
+  const axes = Object.keys(selection);
+  if (axes.length === 0) return null;
+  return product.variants.find(
+    (variant) => axes.every((axis) => variant.attributes.some((a) => a.name === axis && a.value === selection[axis]))
+  ) ?? null;
+}
+function availableAxisValues(product, axisName, selection) {
+  const others = Object.entries(selection).filter(([name]) => name !== axisName);
+  const values = /* @__PURE__ */ new Set();
+  for (const variant of product.variants) {
+    const matchesOthers = others.every(
+      ([name, value]) => variant.attributes.some((a) => a.name === name && a.value === value)
+    );
+    if (!matchesOthers) continue;
+    const own = variant.attributes.find((a) => a.name === axisName);
+    if (own) values.add(own.value);
+  }
+  return [...values];
+}
+function buildVariantComparison(product, labels, formatPriceValue) {
+  const rows = [];
+  const axisNames = /* @__PURE__ */ new Set();
+  for (const variant of product.variants) {
+    for (const attribute of variant.attributes) axisNames.add(attribute.name);
+  }
+  for (const axis of axisNames) {
+    const values = product.variants.map(
+      (v) => v.attributes.find((a) => a.name === axis)?.value ?? "-"
+    );
+    if (new Set(values).size <= 1) continue;
+    rows.push({ label: axis, values });
+  }
+  rows.push({
+    label: labels.price,
+    values: product.variants.map((v) => formatPriceValue(v))
+  });
+  rows.push({
+    label: labels.availability,
+    values: product.variants.map((v) => v.inStock ? labels.inStock : labels.soldOut)
+  });
+  const parameterLabels = /* @__PURE__ */ new Set();
+  for (const variant of product.variants) {
+    for (const group of variant.parameterGroups ?? []) {
+      for (const parameter of group.parameters ?? []) parameterLabels.add(parameter.label);
+    }
+  }
+  for (const label of parameterLabels) {
+    const values = product.variants.map((variant) => {
+      for (const group of variant.parameterGroups ?? []) {
+        const hit = group.parameters?.find((p) => p.label === label);
+        if (!hit) continue;
+        if (hit.value) return [hit.value, hit.unit].filter(Boolean).join(" ");
+        if (hit.booleanValue !== null) return hit.booleanValue ? "\u2713" : "-";
+      }
+      return "-";
+    });
+    if (new Set(values).size <= 1) continue;
+    rows.push({ label, values });
+  }
+  return rows;
+}
+
 // src/analytics.ts
 var GA4_NAME_MAP = {
   newsletter_signup: "generate_lead"
@@ -70,9 +167,9 @@ function generateVisitorId() {
     globalThis.crypto?.getRandomValues?.(bytes);
   } catch {
   }
-  let filled = false;
-  for (const b of bytes) if (b !== 0) filled = true;
-  if (!filled) for (let i = 0; i < bytes.length; i++) bytes[i] = Math.floor(Math.random() * 256);
+  let filled2 = false;
+  for (const b of bytes) if (b !== 0) filled2 = true;
+  if (!filled2) for (let i = 0; i < bytes.length; i++) bytes[i] = Math.floor(Math.random() * 256);
   let bin = "";
   for (const b of bytes) bin += String.fromCharCode(b);
   const b64 = typeof btoa === "function" ? btoa(bin) : Buffer.from(bytes).toString("base64");
@@ -130,13 +227,20 @@ export {
   OrderStatuses,
   PaymentStatuses,
   ProductSort,
+  VARIANT_QUERY_PARAM,
+  availableAxisValues,
+  buildVariantComparison,
   err,
+  findVariantByAttributes,
   formatPrice,
   generateVisitorId,
   getStoredVisitorId,
   grantAnalyticsConsent,
   ok,
+  resolveVariantContent,
   revokeAnalyticsConsent,
   toSdkError,
-  trackEcommerceEvent
+  trackEcommerceEvent,
+  variantFromQuery,
+  variantHref
 };

package/dist/next.d.mts

@@ -1,4 +1,4 @@
-import { n as BehioStorefrontConfig, B as BehioStorefront } from './client-BKNtLTcu.mjs';
+import { o as BehioStorefrontConfig, B as BehioStorefront } from './client-BU8Kfb74.mjs';
 
 interface GetBehioOptions extends Partial<BehioStorefrontConfig> {
     /** Override the cart session cookie name (default: "behio_cart_session"). */

package/dist/next.d.ts

@@ -1,4 +1,4 @@
-import { n as BehioStorefrontConfig, B as BehioStorefront } from './client-BKNtLTcu.js';
+import { o as BehioStorefrontConfig, B as BehioStorefront } from './client-BU8Kfb74.js';
 
 interface GetBehioOptions extends Partial<BehioStorefrontConfig> {
     /** Override the cart session cookie name (default: "behio_cart_session"). */

package/dist/react.d.mts

@@ -327,7 +327,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
@@ -569,6 +617,25 @@ interface VariantAxisValue {
  * configured the axis (the storefront's historical default). Join to
  * `variants[].attributes` by axis `name` + `value`.
  */
+/**
+ * Sourozenecká karta při rozpadu katalogu podle osy (typicky barvy).
+ *
+ * Každá barva je samostatný produkt s vlastní adresou, fotkami a SEO, takže
+ * kolečka barev se vykreslují jako odkazy (`<a href>`), ne jako přepínač uvnitř
+ * stránky. Bez odkazu by je nešlo indexovat a nefungovaly by bez JavaScriptu.
+ */
+interface ProductSibling {
+    productId: string;
+    /** Adresa karty; skládá se s cestou produktu ve storefrontu. */
+    slug: string;
+    name: string;
+    /** Hodnota osy ("Růžová"); null u hlavního produktu skupiny. */
+    axisValue: string | null;
+    swatchColor: string | null;
+    swatchImage: string | null;
+    /** Tahle karta je právě otevřená stránka. */
+    isCurrent: boolean;
+}
 interface VariantAxis {
     name: string;
     displayType: "DROPDOWN" | "BUTTON" | "SWATCH_COLOR" | "SWATCH_IMAGE";
@@ -639,6 +706,11 @@ interface ProductDetail extends ProductListItem {
      * Empty when the product has no variants.
      */
     variantAxes: VariantAxis[];
+    /**
+     * Sourozenecké karty při rozpadu podle osy. Prázdné u e-shopu, který rozpad
+     * nepoužívá, tedy ve výchozím nastavení.
+     */
+    catalogSiblings: ProductSibling[];
     volumePricing: ProductVolumePrice[];
     /**
      * Curated parameter groups, already resolved. Empty when the merchant
@@ -948,7 +1020,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;

package/dist/react.d.ts

@@ -327,7 +327,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
@@ -569,6 +617,25 @@ interface VariantAxisValue {
  * configured the axis (the storefront's historical default). Join to
  * `variants[].attributes` by axis `name` + `value`.
  */
+/**
+ * Sourozenecká karta při rozpadu katalogu podle osy (typicky barvy).
+ *
+ * Každá barva je samostatný produkt s vlastní adresou, fotkami a SEO, takže
+ * kolečka barev se vykreslují jako odkazy (`<a href>`), ne jako přepínač uvnitř
+ * stránky. Bez odkazu by je nešlo indexovat a nefungovaly by bez JavaScriptu.
+ */
+interface ProductSibling {
+    productId: string;
+    /** Adresa karty; skládá se s cestou produktu ve storefrontu. */
+    slug: string;
+    name: string;
+    /** Hodnota osy ("Růžová"); null u hlavního produktu skupiny. */
+    axisValue: string | null;
+    swatchColor: string | null;
+    swatchImage: string | null;
+    /** Tahle karta je právě otevřená stránka. */
+    isCurrent: boolean;
+}
 interface VariantAxis {
     name: string;
     displayType: "DROPDOWN" | "BUTTON" | "SWATCH_COLOR" | "SWATCH_IMAGE";
@@ -639,6 +706,11 @@ interface ProductDetail extends ProductListItem {
      * Empty when the product has no variants.
      */
     variantAxes: VariantAxis[];
+    /**
+     * Sourozenecké karty při rozpadu podle osy. Prázdné u e-shopu, který rozpad
+     * nepoužívá, tedy ve výchozím nastavení.
+     */
+    catalogSiblings: ProductSibling[];
     volumePricing: ProductVolumePrice[];
     /**
      * Curated parameter groups, already resolved. Empty when the merchant
@@ -948,7 +1020,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;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@behio/storefront-sdk",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "TypeScript SDK for Behio Headless E-Shop — core client + React hooks",
   "author": "Behio",
   "license": "MIT",