@nextblock-cms/ecom 0.19.0 → 0.19.3

package/lib/states.es.js

@@ -1,4 +1,4 @@
-import { normalizeCountryCode as t } from "./countries.es.js";
+import { normalizeCountryCode as i } from "./countries.es.js";
 const C = [
   { code: "AL", name: "Alabama" },
   { code: "AK", name: "Alaska" },
@@ -51,7 +51,7 @@ const C = [
   { code: "WV", name: "West Virginia" },
   { code: "WI", name: "Wisconsin" },
   { code: "WY", name: "Wyoming" }
-], u = [
+], A = [
   { code: "AB", name: "Alberta" },
   { code: "BC", name: "British Columbia" },
   { code: "MB", name: "Manitoba" },
@@ -65,10 +65,43 @@ const C = [
   { code: "QC", name: "Quebec" },
   { code: "SK", name: "Saskatchewan" },
   { code: "YT", name: "Yukon" }
-], i = {
+], t = {
   US: C,
-  CA: u
-}, N = {
+  CA: A
+}, l = {
+  CA: {
+    BC: "Colombie-Britannique",
+    NB: "Nouveau-Brunswick",
+    NL: "Terre-Neuve-et-Labrador",
+    NS: "Nouvelle-Écosse",
+    NT: "Territoires du Nord-Ouest",
+    PE: "Île-du-Prince-Édouard",
+    QC: "Québec"
+  },
+  US: {
+    CA: "Californie",
+    DC: "District de Columbia",
+    FL: "Floride",
+    GA: "Géorgie",
+    HI: "Hawaï",
+    LA: "Louisiane",
+    NC: "Caroline du Nord",
+    ND: "Dakota du Nord",
+    NM: "Nouveau-Mexique",
+    PA: "Pennsylvanie",
+    SC: "Caroline du Sud",
+    SD: "Dakota du Sud",
+    VA: "Virginie",
+    WV: "Virginie-Occidentale"
+  }
+};
+function T(n, e, o) {
+  if (!o || !o.toLowerCase().startsWith("fr"))
+    return e.name;
+  const a = i(n);
+  return a && l[a]?.[e.code] || e.name;
+}
+const s = {
   US: {
     CALIFORNIA: "CA",
     NEWYORK: "NY",
@@ -89,39 +122,40 @@ const C = [
     PRINCEEDWARDISLAND: "PE"
   }
 };
-function I(e) {
-  const n = t(e);
-  return n ? i[n] ?? [] : [];
+function S(n) {
+  const e = i(n);
+  return e ? t[e] ?? [] : [];
 }
-function T(e) {
-  return I(e).length > 0;
+function R(n) {
+  return S(n).length > 0;
 }
-function l(e, n) {
-  const o = t(e), a = n?.trim();
+function I(n, e) {
+  const o = i(n), a = e?.trim();
   if (!o || !a)
     return a || null;
-  const d = i[o];
+  const d = t[o];
   if (!d?.length)
     return a.toUpperCase();
-  const c = a.toUpperCase(), r = d.find((m) => m.code === c);
-  if (r)
-    return r.code;
-  const s = d.find((m) => m.name.toUpperCase() === c);
-  if (s)
-    return s.code;
-  const A = c.replace(/\s+/g, "");
-  return N[o]?.[c] ?? N[o]?.[A] ?? c;
+  const c = a.toUpperCase(), m = d.find((r) => r.code === c);
+  if (m)
+    return m.code;
+  const N = d.find((r) => r.name.toUpperCase() === c);
+  if (N)
+    return N.code;
+  const u = c.replace(/\s+/g, "");
+  return s[o]?.[c] ?? s[o]?.[u] ?? c;
 }
-function R(e, n) {
-  const o = t(e), a = l(e, n);
-  return !o || !a ? n ?? null : i[o]?.find(
+function E(n, e) {
+  const o = i(n), a = I(n, e);
+  return !o || !a ? e ?? null : t[o]?.find(
     (c) => c.code === a
   )?.name ?? a;
 }
 export {
-  i as STATES_BY_COUNTRY,
-  T as countryUsesStructuredStates,
-  I as getStatesForCountry,
-  l as normalizeSubdivisionCode,
-  R as resolveSubdivisionName
+  t as STATES_BY_COUNTRY,
+  R as countryUsesStructuredStates,
+  S as getStatesForCountry,
+  T as getSubdivisionLabel,
+  I as normalizeSubdivisionCode,
+  E as resolveSubdivisionName
 };

package/lib/trials.cjs.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function t(e){const r=Number(e?.trial_period_days??0);return!Number.isFinite(r)||r<=0?0:Math.round(r)}function i(e){return t(e)===0?null:e?.trial_requires_payment_method?"paid":"free"}function a(e){const r=t(typeof e=="number"?{trial_period_days:e}:e);return r>0?`${r}-day free trial`:null}function n(e){return e?.trial_requires_payment_method?"Payment method required":"No credit card required"}function o(e){const r=a(e);return r?{label:r,paymentRequirementLabel:n(e),checkoutMode:i(e)}:null}exports.getTrialCheckoutMode=i;exports.getTrialLabel=a;exports.getTrialPaymentRequirementLabel=n;exports.getTrialPeriodDays=t;exports.getTrialSummary=o;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function i(e){const r=Number(e?.trial_period_days??0);return!Number.isFinite(r)||r<=0?0:Math.round(r)}function o(e){return i(e)===0?null:e?.trial_requires_payment_method?"paid":"free"}function a(e,r,t,d){if(!e)return t;const n=e(r,d);return n===r?t:n}function l(e,r){const t=i(typeof e=="number"?{trial_period_days:e}:e);return t>0?a(r,"ecommerce.trial_days",`${t}-day free trial`,{count:t}):null}function u(e,r){return e?.trial_requires_payment_method?a(r,"ecommerce.trial_payment_required","Payment method required"):a(r,"ecommerce.trial_no_card","No credit card required")}function m(e,r){const t=l(e,r);return t?{label:t,paymentRequirementLabel:u(e,r),checkoutMode:o(e)}:null}exports.getTrialCheckoutMode=o;exports.getTrialLabel=l;exports.getTrialPaymentRequirementLabel=u;exports.getTrialPeriodDays=i;exports.getTrialSummary=m;

package/lib/trials.d.ts

@@ -5,9 +5,16 @@ type TrialCarrier = {
 };
 export declare function getTrialPeriodDays(value: TrialCarrier | null | undefined): number;
 export declare function getTrialCheckoutMode(value: TrialCarrier | null | undefined): FreemiusTrialMode | null;
-export declare function getTrialLabel(value: TrialCarrier | number | null | undefined): string | null;
-export declare function getTrialPaymentRequirementLabel(value: TrialCarrier | null | undefined): "Payment method required" | "No credit card required";
-export declare function getTrialSummary(value: TrialCarrier | null | undefined): {
+/** The `t` of `useTranslations()`. It answers an unseeded key with the key itself. */
+export type TrialTranslate = (key: string, params?: Record<string, string | number>) => string;
+/**
+ * Pass `t` from a component to get the label in the visitor's language. Without it the copy
+ * is English: these helpers used to return English only, so every product card, the cart
+ * and the checkout showed "14-day free trial" on French pages.
+ */
+export declare function getTrialLabel(value: TrialCarrier | number | null | undefined, t?: TrialTranslate): string | null;
+export declare function getTrialPaymentRequirementLabel(value: TrialCarrier | null | undefined, t?: TrialTranslate): string;
+export declare function getTrialSummary(value: TrialCarrier | null | undefined, t?: TrialTranslate): {
     label: string;
     paymentRequirementLabel: string;
     checkoutMode: FreemiusTrialMode | null;

package/lib/trials.es.js

@@ -1,29 +1,36 @@
-function t(e) {
-  const r = Number(e?.trial_period_days ?? 0);
-  return !Number.isFinite(r) || r <= 0 ? 0 : Math.round(r);
+function i(r) {
+  const e = Number(r?.trial_period_days ?? 0);
+  return !Number.isFinite(e) || e <= 0 ? 0 : Math.round(e);
 }
-function i(e) {
-  return t(e) === 0 ? null : e?.trial_requires_payment_method ? "paid" : "free";
+function u(r) {
+  return i(r) === 0 ? null : r?.trial_requires_payment_method ? "paid" : "free";
 }
-function n(e) {
-  const r = t(typeof e == "number" ? { trial_period_days: e } : e);
-  return r > 0 ? `${r}-day free trial` : null;
+function n(r, e, t, o) {
+  if (!r) return t;
+  const a = r(e, o);
+  return a === e ? t : a;
 }
-function a(e) {
-  return e?.trial_requires_payment_method ? "Payment method required" : "No credit card required";
+function d(r, e) {
+  const t = i(typeof r == "number" ? { trial_period_days: r } : r);
+  return t > 0 ? n(e, "ecommerce.trial_days", `${t}-day free trial`, {
+    count: t
+  }) : null;
 }
-function o(e) {
-  const r = n(e);
-  return r ? {
-    label: r,
-    paymentRequirementLabel: a(e),
-    checkoutMode: i(e)
+function l(r, e) {
+  return r?.trial_requires_payment_method ? n(e, "ecommerce.trial_payment_required", "Payment method required") : n(e, "ecommerce.trial_no_card", "No credit card required");
+}
+function c(r, e) {
+  const t = d(r, e);
+  return t ? {
+    label: t,
+    paymentRequirementLabel: l(r, e),
+    checkoutMode: u(r)
   } : null;
 }
 export {
-  i as getTrialCheckoutMode,
-  n as getTrialLabel,
-  a as getTrialPaymentRequirementLabel,
-  t as getTrialPeriodDays,
-  o as getTrialSummary
+  u as getTrialCheckoutMode,
+  d as getTrialLabel,
+  l as getTrialPaymentRequirementLabel,
+  i as getTrialPeriodDays,
+  c as getTrialSummary
 };

package/lib/types.d.ts

@@ -89,6 +89,8 @@ export interface Product {
     images?: {
         url: string;
         alt?: string;
+        width?: number;
+        height?: number;
     }[];
     short_description?: string | null;
     description_json?: any;

package/lib/use-price-formatter.cjs.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("@nextblock-cms/utils");function t(e){return e?e==="fr"?"fr-CA":e==="en"?"en-US":e:"en-US"}function c(){const{lang:e}=r.useTranslations(),n=t(e);return(i,o)=>r.formatPrice(i,o,n)}exports.getPriceLocale=t;exports.usePriceFormatter=c;

package/lib/use-price-formatter.d.ts

@@ -0,0 +1,11 @@
+/** The regional locale prices are formatted in, from the site language. */
+export declare function getPriceLocale(lang?: string | null): string;
+/**
+ * `formatPrice` bound to the visitor's language.
+ *
+ * The shared helper defaults to `en-US`, and no shop component passed a locale, so a French
+ * page showed `$1,234.50` instead of `1 234,50 $`. Components take this hook and keep calling
+ * `formatPrice(amount, currency)` as before. The language comes from the translations
+ * provider, which is the same on the server and in the browser: no hydration mismatch.
+ */
+export declare function usePriceFormatter(): (amount: number, currencyCode?: string) => string;

package/lib/use-price-formatter.es.js

@@ -0,0 +1,13 @@
+'use client';
+import { useTranslations as o, formatPrice as i } from "@nextblock-cms/utils";
+function c(r) {
+  return r ? r === "fr" ? "fr-CA" : r === "en" ? "en-US" : r : "en-US";
+}
+function u() {
+  const { lang: r } = o(), e = c(r);
+  return (t, n) => i(t, n, e);
+}
+export {
+  c as getPriceLocale,
+  u as usePriceFormatter
+};

package/lib/variation-utils.cjs.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const b=require("./currency.cjs.js");function f(e){return!e||typeof e!="object"||Array.isArray(e)?null:Object.entries(e).reduce((r,[n,t])=>(typeof t=="string"&&t.trim()&&(r[n]=t.trim()),r),{})}function p(e,r,n){return!n||!r?e:r[n]?.trim()||e}function k(e,r){return p(e.name,e.name_translations,r)}function E(e,r){return p(e.value,e.value_translations,r)}function V(e){return e?e.startsWith("http")?e:process.env.NEXT_PUBLIC_R2_BASE_URL?`${process.env.NEXT_PUBLIC_R2_BASE_URL}/${e}`:process.env.NEXT_PUBLIC_SUPABASE_URL?`${process.env.NEXT_PUBLIC_SUPABASE_URL}/storage/v1/object/public/media/${e}`:e:null}function I(e){return e.toLowerCase().trim().replace(/\s+/g,"-").replace(/[^a-z0-9-]/g,"").replace(/-+/g,"-").replace(/^-|-$/g,"")}function A(e){return[...e].sort().join("__")}function S(e){return e.map(r=>r.term_value).join(" / ")}function P(e){return e.length===0?[]:e.reduce((r,n)=>r.flatMap(t=>n.map(s=>[...t,s])),[[]])}function B(e){const{baseSku:r,basePrice:n,basePrices:t={},baseSalePrice:s=null,baseSalePrices:i={},selectedAttributes:o,previousVariants:c=[]}=e;if(o.length===0||o.some(l=>l.terms.length===0))return[];const u=new Map(c.map(l=>[l.combination_key,l])),a=o.map(l=>l.terms.map(d=>({attribute_id:l.attribute_id,attribute_name:l.attribute_name,term:d})));return P(a).map(l=>{const d=l.map(({attribute_id:m,attribute_name:M,term:g})=>({attribute_id:m,attribute_name:M,term_id:g.id,term_value:g.value,term_slug:g.slug})),T=d.map(m=>m.term_id),h=A(T),_=u.get(h),y=d.map(m=>(m.term_slug?m.term_slug:I(m.term_value)).toUpperCase()).filter(Boolean).join("-");return{id:_?.id,combination_key:h,sku:_?.sku||[r.trim(),y].filter(Boolean).join("-"),upc:_?.upc??null,price:_?.price??n,prices:_?.prices??b.normalizePriceMap(t),sale_price:_?.sale_price??s,sale_prices:_?.sale_prices??b.normalizeSalePriceMap(i),sale_start_at:_?.sale_start_at??null,sale_end_at:_?.sale_end_at??null,stock_quantity:_?.stock_quantity??0,main_media_id:_?.main_media_id??null,main_image_url:_?.main_image_url??null,attribute_term_ids:T,selected_options:d,label:S(d)}})}function R(e){const r={};for(const n of e)for(const t of n.selected_options??[]){const s=new Set(r[t.attribute_id]??[]);s.add(t.term_id),r[t.attribute_id]=[...s]}return r}function U(e,r){const n=Object.values(r).filter(Boolean);return n.length===0?null:e.find(t=>t.attribute_term_ids.length===n.length&&n.every(s=>t.attribute_term_ids.includes(s)))??null}function v(e,r,n){const t=new Set;for(const s of e){if(!Object.entries(n).every(([c,u])=>!u||c===r?!0:s.attribute_term_ids.includes(u)))continue;const o=s.selected_options.find(c=>c.attribute_id===r);o&&t.add(o.term_id)}return t}function j(e,r){const n=r.find(t=>t.stock_quantity>0)??r[0]??null;return n?n.selected_options.reduce((t,s)=>(t[s.attribute_id]=s.term_id,t),{}):e.reduce((t,s)=>{const i=s.terms[0];return i&&(t[s.id]=i.id),t},{})}function z(e,r,n){const t={...n};for(const s of e){const i=v(r,s.id,t);if(i.size===0){delete t[s.id];continue}const o=t[s.id];if(o&&i.has(o))continue;const c=s.terms.find(u=>i.has(u.id));c&&(t[s.id]=c.id)}return t}function L(e=[],r){const n=new Map,t=e.map(i=>{const o=(i.variant_attribute_mapping||[]).map(u=>{const a=u.product_attribute_terms,l=a?.product_attributes;if(!a||!l)return null;const d=n.get(l.id)||{id:l.id,name:p(l.name,f(l.name_translations),r),slug:l.slug,name_translations:f(l.name_translations),terms:[],_termIds:new Set};return d._termIds.has(a.id)||(d.terms.push({id:a.id,attribute_id:a.attribute_id,value:p(a.value,f(a.value_translations),r),slug:a.slug,sort_order:a.sort_order??null,value_translations:f(a.value_translations)}),d._termIds.add(a.id)),n.set(l.id,d),{attribute_id:l.id,attribute_name:p(l.name,f(l.name_translations),r),term_id:a.id,term_value:p(a.value,f(a.value_translations),r),term_slug:a.slug}}).filter(u=>u!==null).sort((u,a)=>u.attribute_name.localeCompare(a.attribute_name)),c=o.map(u=>u.term_id);return{id:i.id,combination_key:A(c),sku:i.sku,upc:i.upc??null,price:i.price??0,prices:b.normalizePriceMap(i.prices),sale_price:i.sale_price??null,sale_prices:b.normalizeSalePriceMap(i.sale_prices),sale_start_at:i.sale_start_at??null,sale_end_at:i.sale_end_at??null,scheduled_price:i.scheduled_price??null,scheduled_prices:b.normalizePriceMap(i.scheduled_prices),scheduled_price_at:i.scheduled_price_at??null,stock_quantity:i.stock_quantity??0,main_media_id:i.main_media_id??null,image_url:V(i.media?.file_path??i.media?.object_key??null),attribute_term_ids:c,selected_options:o,label:S(o)}});return{attributes:[...n.values()].map(i=>({id:i.id,name:i.name,slug:i.slug,name_translations:i.name_translations,terms:[...i.terms].sort((o,c)=>{const u=o.sort_order??Number.MAX_SAFE_INTEGER,a=c.sort_order??Number.MAX_SAFE_INTEGER;return u!==a?u-a:o.value.localeCompare(c.value)})})).sort((i,o)=>i.name.localeCompare(o.name)),variants:t}}function N(e,r){if(!e.length)return null;const n=e.map(t=>b.isSaleWindowActive({saleStartAt:t.sale_start_at,saleEndAt:t.sale_end_at,now:r})&&typeof t.sale_price=="number"?t.sale_price:t.price);return{min:Math.min(...n),max:Math.max(...n)}}exports.buildCombinationKey=A;exports.buildVariantLabel=S;exports.chooseInitialVariantSelections=j;exports.extractSelectedTermsByAttribute=R;exports.findMatchingVariant=U;exports.generateVariantDrafts=B;exports.getAvailableTermIdsForAttribute=v;exports.getVariantEffectivePriceRange=N;exports.mapRawVariantRelations=L;exports.normalizeSelectionsToAvailableVariants=z;exports.resolveAttributeName=k;exports.resolveTermValue=E;exports.resolveTranslatedText=p;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const b=require("./currency.cjs.js");function f(e){return!e||typeof e!="object"||Array.isArray(e)?null:Object.entries(e).reduce((i,[n,t])=>(typeof t=="string"&&t.trim()&&(i[n]=t.trim()),i),{})}function p(e,i,n){return!n||!i?e:i[n]?.trim()||e}function V(e,i){return p(e.name,e.name_translations,i)}function M(e,i){return p(e.value,e.value_translations,i)}function E(e){return e?e.startsWith("http")?e:process.env.NEXT_PUBLIC_R2_BASE_URL?`${process.env.NEXT_PUBLIC_R2_BASE_URL}/${e}`:process.env.NEXT_PUBLIC_SUPABASE_URL?`${process.env.NEXT_PUBLIC_SUPABASE_URL}/storage/v1/object/public/media/${e}`:e:null}function I(e){return e.toLowerCase().trim().replace(/\s+/g,"-").replace(/[^a-z0-9-]/g,"").replace(/-+/g,"-").replace(/^-|-$/g,"")}function S(e){return[...e].sort().join("__")}function A(e){return e.map(i=>i.term_value).join(" / ")}function P(e){return e.length===0?[]:e.reduce((i,n)=>i.flatMap(t=>n.map(a=>[...t,a])),[[]])}function B(e){const{baseSku:i,basePrice:n,basePrices:t={},baseSalePrice:a=null,baseSalePrices:r={},selectedAttributes:s,previousVariants:c=[]}=e;if(s.length===0||s.some(o=>o.terms.length===0))return[];const u=new Map(c.map(o=>[o.combination_key,o])),l=s.map(o=>o.terms.map(d=>({attribute_id:o.attribute_id,attribute_name:o.attribute_name,term:d})));return P(l).map(o=>{const d=o.map(({attribute_id:m,attribute_name:k,term:g})=>({attribute_id:m,attribute_name:k,term_id:g.id,term_value:g.value,term_slug:g.slug})),h=d.map(m=>m.term_id),y=S(h),_=u.get(y),v=d.map(m=>(m.term_slug?m.term_slug:I(m.term_value)).toUpperCase()).filter(Boolean).join("-");return{id:_?.id,combination_key:y,sku:_?.sku||[i.trim(),v].filter(Boolean).join("-"),upc:_?.upc??null,price:_?.price??n,prices:_?.prices??b.normalizePriceMap(t),sale_price:_?.sale_price??a,sale_prices:_?.sale_prices??b.normalizeSalePriceMap(r),sale_start_at:_?.sale_start_at??null,sale_end_at:_?.sale_end_at??null,stock_quantity:_?.stock_quantity??0,main_media_id:_?.main_media_id??null,main_image_url:_?.main_image_url??null,attribute_term_ids:h,selected_options:d,label:A(d)}})}function R(e){const i={};for(const n of e)for(const t of n.selected_options??[]){const a=new Set(i[t.attribute_id]??[]);a.add(t.term_id),i[t.attribute_id]=[...a]}return i}function U(e,i){const n=Object.values(i).filter(Boolean);return n.length===0?null:e.find(t=>t.attribute_term_ids.length===n.length&&n.every(a=>t.attribute_term_ids.includes(a)))??null}function T(e,i,n){const t=new Set;for(const a of e){if(!Object.entries(n).every(([c,u])=>!u||c===i?!0:a.attribute_term_ids.includes(u)))continue;const s=a.selected_options.find(c=>c.attribute_id===i);s&&t.add(s.term_id)}return t}function j(e,i){const n=i.find(t=>t.stock_quantity>0)??i[0]??null;return n?n.selected_options.reduce((t,a)=>(t[a.attribute_id]=a.term_id,t),{}):e.reduce((t,a)=>{const r=a.terms[0];return r&&(t[a.id]=r.id),t},{})}function z(e,i,n,t,a){const r={[t]:a};for(const s of e){if(s.id===t)continue;const c=T(i,s.id,r),u=n[s.id];if(u&&c.has(u)){r[s.id]=u;continue}const l=s.terms.find(o=>c.has(o.id));l&&(r[s.id]=l.id)}return r}function L(e,i,n){const t={...n};for(const a of e){const r=T(i,a.id,t);if(r.size===0){delete t[a.id];continue}const s=t[a.id];if(s&&r.has(s))continue;const c=a.terms.find(u=>r.has(u.id));c&&(t[a.id]=c.id)}return t}function N(e=[],i){const n=new Map,t=e.map(r=>{const s=(r.variant_attribute_mapping||[]).map(u=>{const l=u.product_attribute_terms,o=l?.product_attributes;if(!l||!o)return null;const d=n.get(o.id)||{id:o.id,name:p(o.name,f(o.name_translations),i),slug:o.slug,name_translations:f(o.name_translations),terms:[],_termIds:new Set};return d._termIds.has(l.id)||(d.terms.push({id:l.id,attribute_id:l.attribute_id,value:p(l.value,f(l.value_translations),i),slug:l.slug,sort_order:l.sort_order??null,value_translations:f(l.value_translations)}),d._termIds.add(l.id)),n.set(o.id,d),{attribute_id:o.id,attribute_name:p(o.name,f(o.name_translations),i),term_id:l.id,term_value:p(l.value,f(l.value_translations),i),term_slug:l.slug}}).filter(u=>u!==null).sort((u,l)=>u.attribute_name.localeCompare(l.attribute_name)),c=s.map(u=>u.term_id);return{id:r.id,combination_key:S(c),sku:r.sku,upc:r.upc??null,price:r.price??0,prices:b.normalizePriceMap(r.prices),sale_price:r.sale_price??null,sale_prices:b.normalizeSalePriceMap(r.sale_prices),sale_start_at:r.sale_start_at??null,sale_end_at:r.sale_end_at??null,scheduled_price:r.scheduled_price??null,scheduled_prices:b.normalizePriceMap(r.scheduled_prices),scheduled_price_at:r.scheduled_price_at??null,stock_quantity:r.stock_quantity??0,main_media_id:r.main_media_id??null,image_url:E(r.media?.file_path??r.media?.object_key??null),attribute_term_ids:c,selected_options:s,label:A(s)}});return{attributes:[...n.values()].map(r=>({id:r.id,name:r.name,slug:r.slug,name_translations:r.name_translations,terms:[...r.terms].sort((s,c)=>{const u=s.sort_order??Number.MAX_SAFE_INTEGER,l=c.sort_order??Number.MAX_SAFE_INTEGER;return u!==l?u-l:s.value.localeCompare(c.value)})})).sort((r,s)=>r.name.localeCompare(s.name)),variants:t}}function O(e,i){if(!e.length)return null;const n=e.map(t=>b.isSaleWindowActive({saleStartAt:t.sale_start_at,saleEndAt:t.sale_end_at,now:i})&&typeof t.sale_price=="number"?t.sale_price:t.price);return{min:Math.min(...n),max:Math.max(...n)}}exports.applyVariantSelection=z;exports.buildCombinationKey=S;exports.buildVariantLabel=A;exports.chooseInitialVariantSelections=j;exports.extractSelectedTermsByAttribute=R;exports.findMatchingVariant=U;exports.generateVariantDrafts=B;exports.getAvailableTermIdsForAttribute=T;exports.getVariantEffectivePriceRange=O;exports.mapRawVariantRelations=N;exports.normalizeSelectionsToAvailableVariants=L;exports.resolveAttributeName=V;exports.resolveTermValue=M;exports.resolveTranslatedText=p;

package/lib/variation-utils.d.ts

@@ -59,6 +59,16 @@ export declare function extractSelectedTermsByAttribute(variants: Array<{
 export declare function findMatchingVariant(variants: ProductVariant[], selections: Record<string, string | undefined>): ProductVariant | null;
 export declare function getAvailableTermIdsForAttribute(variants: ProductVariant[], attributeId: string, selections: Record<string, string | undefined>): Set<string>;
 export declare function chooseInitialVariantSelections(attributes: ProductAttribute[], variants: ProductVariant[]): Record<string, string>;
+/**
+ * The selections after the shopper picks `termId` for `attributeId`.
+ *
+ * The pick always wins. Every other attribute keeps its current term when some variant
+ * combines it with everything chosen so far, and otherwise moves to the first term that
+ * does. With a sparse matrix (only Red/S and Blue/M exist) choosing Blue therefore lands on
+ * Blue/M. The old flow re-normalized `{...current, [attributeId]: termId}` attribute by
+ * attribute, which reverted the pick itself whenever it clashed with another dropdown.
+ */
+export declare function applyVariantSelection(attributes: ProductAttribute[], variants: ProductVariant[], current: Record<string, string | undefined>, attributeId: string, termId: string): Record<string, string | undefined>;
 export declare function normalizeSelectionsToAvailableVariants(attributes: ProductAttribute[], variants: ProductVariant[], selections: Record<string, string | undefined>): {
     [x: string]: string | undefined;
 };