@sixtyninecommerce/client 0.23.1 → 0.25.0

package/dist/pricing/tax-display.d.ts

@@ -1,9 +1,86 @@
+/**
+ * Which tax figure a shopper sees: incl. (`gross`) or excl. (`net`) tax.
+ *
+ * `Channel.pricesIncludeTax` is a STORAGE mode — it says which of `price` /
+ * `priceWithTax` the merchant typed in, not which one this shopper should be
+ * quoted. Those differ in real shops: US sales tax varies by state and even by
+ * district, so a US shopper must never be quoted a tax-inclusive price, and
+ * Dutch B2B buyers work in ex-VAT numbers, while Dutch consumers keep seeing
+ * the gross price the law requires. One channel, three audiences.
+ *
+ * So the engine resolves the mode per request and exposes it as
+ * `Query.activeTaxDisplayMode` — that query is the authority, and
+ * `client.pricing.getTaxDisplayMode()` is how a storefront reads it. The pure
+ * helpers below mirror the engine's rules
+ * (`services/vendure/src/tax-display/tax-display-policy.ts`) RULE FOR RULE so a
+ * client can preview a mode — a "who sees what" table, an SSR guess before the
+ * first round-trip — without one. Change one, change both.
+ *
+ * The channel policy behind it (three `public: true` Channel customFields, all
+ * defaulting to today's behaviour):
+ *
+ *   taxDisplayDefault      channel | gross | net    (default `channel`)
+ *   taxDisplayB2b          inherit | gross | net    (default `inherit`)
+ *   taxExclusiveCountries  JSON ["US"]              (default empty)
+ */
 import type { StoreContext, TaxDisplayInputs, TaxDisplayMode, TaxDisplayPolicy } from '../types.js';
+/** Every channel reads this until a merchant changes something. */
 export declare const DEFAULT_TAX_DISPLAY_POLICY: TaxDisplayPolicy;
+/**
+ * The resolved mode for the active shopper. Public, anonymous-safe, and it
+ * never errors server-side — a lookup failure there falls back to the channel
+ * default rather than failing the request.
+ *
+ * The answer depends on the request's identity, so the SDK sends it with the
+ * same `Authorization` / `x-order-scope` headers as every other call.
+ */
 export declare const ACTIVE_TAX_DISPLAY_MODE = "\n  query ActiveTaxDisplayMode {\n    activeTaxDisplayMode\n  }\n";
+/**
+ * Resolve the mode for one shopper — the engine's rule, offline.
+ *
+ * Precedence — country, then B2B, then the default — and the order is the
+ * point. A US dealer is a US shopper first: their state's sales tax is the
+ * reason the price cannot be quoted gross, and that reason does not go away
+ * because they also happen to be a trade account.
+ *
+ * This is a PREVIEW. `getTaxDisplayMode()` is what a storefront renders from;
+ * only the server knows the shopper's resolved country (active order shipping
+ * address, else their default shipping address).
+ */
 export declare function resolveTaxDisplayMode(policy: TaxDisplayPolicy, inputs: TaxDisplayInputs): TaxDisplayMode;
+/**
+ * Read the policy off `activeChannel.customFields`. LENIENT by design: an
+ * unreadable value degrades to the pre-policy default rather than throwing
+ * while a catalogue page renders. The dashboard's write-side validation is what
+ * stops a bad value being stored.
+ */
 export declare function parseTaxDisplayPolicy(fields: unknown): TaxDisplayPolicy;
+/**
+ * The tax-exclusive country list, normalised to upper-case alpha-2 with
+ * duplicates dropped. Anything unreadable is an EMPTY list — the rule is
+ * opt-in, so falling open means "no country override", never "every country".
+ */
 export declare function parseTaxExclusiveCountries(raw: unknown): readonly string[];
+/**
+ * Map the Shop API enum (`GROSS` / `NET`, upper-case like `OrderScope`) to the
+ * SDK's lower-case union. Returns `null` for anything else — an engine that
+ * predates the enum, a null, a typo — so the caller can fall back to the
+ * channel storage mode instead of rendering a guess.
+ */
 export declare function taxDisplayModeFromEnum(value: unknown): TaxDisplayMode | null;
+/**
+ * Identity fingerprint of the current request context — the cache key for a
+ * resolved mode.
+ *
+ * The mode is a function of WHO is asking: the session (`Authorization`) and
+ * the storefront scope (`x-order-scope`) are the two things the SDK can change
+ * mid-session that also change the answer. Sign in, sign out, or switch to the
+ * trade portal and the stamp changes, so the next read re-resolves instead of
+ * showing the previous shopper's mode.
+ *
+ * A country change is the one non-identity input that can flip the mode; it is
+ * handled by clearing the cache in `setShippingAddress`, since the stamp cannot
+ * see it.
+ */
 export declare function identityStamp(ctx: Pick<StoreContext, 'authToken' | 'orderScope'>): string;
 //# sourceMappingURL=tax-display.d.ts.map

package/dist/pricing/tax-display.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tax-display.d.ts","sourceRoot":"","sources":["../../src/pricing/tax-display.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EACV,YAAY,EAGZ,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EACjB,MAAM,aAAa,CAAC;AAYrB,eAAO,MAAM,0BAA0B,EAAE,gBAIxC,CAAC;AAUF,eAAO,MAAM,uBAAuB,sEAInC,CAAC;AAyBF,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,gBAAgB,GACvB,cAAc,CAShB;AAQD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,GAAG,gBAAgB,CAWvE;AAOD,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,OAAO,GAAG,SAAS,MAAM,EAAE,CAoB1E;AAQD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,GAAG,IAAI,CAM5E;AAgBD,wBAAgB,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,YAAY,EAAE,WAAW,GAAG,YAAY,CAAC,GAAG,MAAM,CAEzF"}
+{"version":3,"file":"tax-display.d.ts","sourceRoot":"","sources":["../../src/pricing/tax-display.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EACV,YAAY,EAGZ,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EACjB,MAAM,aAAa,CAAC;AAWrB,mEAAmE;AACnE,eAAO,MAAM,0BAA0B,EAAE,gBAIxC,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,sEAInC,CAAC;AAaF;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,gBAAgB,GACvB,cAAc,CAShB;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,GAAG,gBAAgB,CAWvE;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,OAAO,GAAG,SAAS,MAAM,EAAE,CAoB1E;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,GAAG,IAAI,CAM5E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,YAAY,EAAE,WAAW,GAAG,YAAY,CAAC,GAAG,MAAM,CAEzF"}

package/dist/pricing/tax-display.js

@@ -1,22 +1,76 @@
+/**
+ * Which tax figure a shopper sees: incl. (`gross`) or excl. (`net`) tax.
+ *
+ * `Channel.pricesIncludeTax` is a STORAGE mode — it says which of `price` /
+ * `priceWithTax` the merchant typed in, not which one this shopper should be
+ * quoted. Those differ in real shops: US sales tax varies by state and even by
+ * district, so a US shopper must never be quoted a tax-inclusive price, and
+ * Dutch B2B buyers work in ex-VAT numbers, while Dutch consumers keep seeing
+ * the gross price the law requires. One channel, three audiences.
+ *
+ * So the engine resolves the mode per request and exposes it as
+ * `Query.activeTaxDisplayMode` — that query is the authority, and
+ * `client.pricing.getTaxDisplayMode()` is how a storefront reads it. The pure
+ * helpers below mirror the engine's rules
+ * (`services/vendure/src/tax-display/tax-display-policy.ts`) RULE FOR RULE so a
+ * client can preview a mode — a "who sees what" table, an SSR guess before the
+ * first round-trip — without one. Change one, change both.
+ *
+ * The channel policy behind it (three `public: true` Channel customFields, all
+ * defaulting to today's behaviour):
+ *
+ *   taxDisplayDefault      channel | gross | net    (default `channel`)
+ *   taxDisplayB2b          inherit | gross | net    (default `inherit`)
+ *   taxExclusiveCountries  JSON ["US"]              (default empty)
+ */
+/** ISO-3166 alpha-2: exactly two ASCII letters. */
 const ALPHA2 = /^[A-Za-z]{2}$/;
+/** Channel-wide default. `channel` follows `Channel.pricesIncludeTax`. */
 const TAX_DISPLAY_DEFAULTS = ['channel', 'gross', 'net'];
+/** B2B override. `inherit` leaves B2B shoppers on the channel default. */
 const TAX_DISPLAY_B2B_MODES = ['inherit', 'gross', 'net'];
+/** Every channel reads this until a merchant changes something. */
 export const DEFAULT_TAX_DISPLAY_POLICY = {
     default: 'channel',
     b2b: 'inherit',
     countries: [],
 };
+/**
+ * The resolved mode for the active shopper. Public, anonymous-safe, and it
+ * never errors server-side — a lookup failure there falls back to the channel
+ * default rather than failing the request.
+ *
+ * The answer depends on the request's identity, so the SDK sends it with the
+ * same `Authorization` / `x-order-scope` headers as every other call.
+ */
 export const ACTIVE_TAX_DISPLAY_MODE = `
   query ActiveTaxDisplayMode {
     activeTaxDisplayMode
   }
 `;
+/**
+ * Trim and upper-case one country code, or `null` when it is not a plausible
+ * alpha-2 code. Applied to both the stored list and the country being judged,
+ * so `"us"` and `" US "` can never disagree with `"US"`.
+ */
 function normalizeCountryCode(raw) {
     if (typeof raw !== 'string')
         return null;
     const trimmed = raw.trim();
     return ALPHA2.test(trimmed) ? trimmed.toUpperCase() : null;
 }
+/**
+ * Resolve the mode for one shopper — the engine's rule, offline.
+ *
+ * Precedence — country, then B2B, then the default — and the order is the
+ * point. A US dealer is a US shopper first: their state's sales tax is the
+ * reason the price cannot be quoted gross, and that reason does not go away
+ * because they also happen to be a trade account.
+ *
+ * This is a PREVIEW. `getTaxDisplayMode()` is what a storefront renders from;
+ * only the server knows the shopper's resolved country (active order shipping
+ * address, else their default shipping address).
+ */
 export function resolveTaxDisplayMode(policy, inputs) {
     const country = normalizeCountryCode(inputs.countryCode);
     if (country !== null && policy.countries.includes(country))
@@ -27,6 +81,12 @@ export function resolveTaxDisplayMode(policy, inputs) {
         return policy.default;
     return inputs.pricesIncludeTax ? 'gross' : 'net';
 }
+/**
+ * Read the policy off `activeChannel.customFields`. LENIENT by design: an
+ * unreadable value degrades to the pre-policy default rather than throwing
+ * while a catalogue page renders. The dashboard's write-side validation is what
+ * stops a bad value being stored.
+ */
 export function parseTaxDisplayPolicy(fields) {
     const raw = (fields ?? {});
     return {
@@ -35,6 +95,11 @@ export function parseTaxDisplayPolicy(fields) {
         countries: parseTaxExclusiveCountries(raw.taxExclusiveCountries),
     };
 }
+/**
+ * The tax-exclusive country list, normalised to upper-case alpha-2 with
+ * duplicates dropped. Anything unreadable is an EMPTY list — the rule is
+ * opt-in, so falling open means "no country override", never "every country".
+ */
 export function parseTaxExclusiveCountries(raw) {
     if (typeof raw !== 'string')
         return [];
@@ -59,6 +124,12 @@ export function parseTaxExclusiveCountries(raw) {
     }
     return codes;
 }
+/**
+ * Map the Shop API enum (`GROSS` / `NET`, upper-case like `OrderScope`) to the
+ * SDK's lower-case union. Returns `null` for anything else — an engine that
+ * predates the enum, a null, a typo — so the caller can fall back to the
+ * channel storage mode instead of rendering a guess.
+ */
 export function taxDisplayModeFromEnum(value) {
     if (typeof value !== 'string')
         return null;
@@ -69,6 +140,20 @@ export function taxDisplayModeFromEnum(value) {
         return 'net';
     return null;
 }
+/**
+ * Identity fingerprint of the current request context — the cache key for a
+ * resolved mode.
+ *
+ * The mode is a function of WHO is asking: the session (`Authorization`) and
+ * the storefront scope (`x-order-scope`) are the two things the SDK can change
+ * mid-session that also change the answer. Sign in, sign out, or switch to the
+ * trade portal and the stamp changes, so the next read re-resolves instead of
+ * showing the previous shopper's mode.
+ *
+ * A country change is the one non-identity input that can flip the mode; it is
+ * handled by clearing the cache in `setShippingAddress`, since the stamp cannot
+ * see it.
+ */
 export function identityStamp(ctx) {
     return `${ctx.authToken ?? ''}|${ctx.orderScope ?? ''}`;
 }

package/dist/pricing/tax-display.js.map

@@ -1 +1 @@
-{"version":3,"file":"tax-display.js","sourceRoot":"","sources":["../../src/pricing/tax-display.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tax-display.js","sourceRoot":"","sources":["../../src/pricing/tax-display.ts"],"names":[],"mappings":"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"}

package/dist/pricing/tiers.d.ts

@@ -1,4 +1,13 @@
 import type { PriceTier, TierTableEntry, VariantPriceData } from '../types.js';
+/**
+ * Find the active price tier for a given quantity.
+ * Tiers are matched by the highest minQuantity that does not exceed the given quantity.
+ * Returns null if no tiers or quantity is below all thresholds.
+ */
 export declare function getTierForQuantity(tiers: PriceTier[], quantity: number): PriceTier | null;
+/**
+ * Build a tier table with savings percentages relative to the retail price.
+ * If no retail price is available, savings are computed relative to the variant's base price.
+ */
 export declare function computeTierTable(variant: VariantPriceData): TierTableEntry[];
 //# sourceMappingURL=tiers.d.ts.map

package/dist/pricing/tiers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tiers.d.ts","sourceRoot":"","sources":["../../src/pricing/tiers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAO/E,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAYzF;AAMD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,GAAG,cAAc,EAAE,CAkB5E"}
+{"version":3,"file":"tiers.d.ts","sourceRoot":"","sources":["../../src/pricing/tiers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/E;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAYzF;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,GAAG,cAAc,EAAE,CAkB5E"}

package/dist/pricing/tiers.js

@@ -1,3 +1,8 @@
+/**
+ * Find the active price tier for a given quantity.
+ * Tiers are matched by the highest minQuantity that does not exceed the given quantity.
+ * Returns null if no tiers or quantity is below all thresholds.
+ */
 export function getTierForQuantity(tiers, quantity) {
     if (!tiers.length)
         return null;
@@ -11,6 +16,10 @@ export function getTierForQuantity(tiers, quantity) {
     }
     return matched;
 }
+/**
+ * Build a tier table with savings percentages relative to the retail price.
+ * If no retail price is available, savings are computed relative to the variant's base price.
+ */
 export function computeTierTable(variant) {
     const tiers = variant.priceTiers;
     if (!tiers?.length)

package/dist/pricing/tiers.js.map

@@ -1 +1 @@
-{"version":3,"file":"tiers.js","sourceRoot":"","sources":["../../src/pricing/tiers.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,kBAAkB,CAAC,KAAkB,EAAE,QAAgB;IACrE,IAAI,CAAC,KAAK,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAE/B,IAAI,OAAO,GAAqB,IAAI,CAAC;IACrC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,QAAQ,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACjC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;gBACvD,OAAO,GAAG,IAAI,CAAC;YACjB,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAMD,MAAM,UAAU,gBAAgB,CAAC,OAAyB;IACxD,MAAM,KAAK,GAAG,OAAO,CAAC,UAAU,CAAC;IACjC,IAAI,CAAC,KAAK,EAAE,MAAM;QAAE,OAAO,EAAE,CAAC;IAE9B,MAAM,cAAc,GAAG,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,KAAK,CAAC;IAC5D,IAAI,cAAc,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IAEnC,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC1B,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,OAAO,EAAE,OAAO,CAAC,cAAc,EAAE,KAAK,IAAI,IAAI;QAC9C,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,iBAAiB,EACf,cAAc,GAAG,CAAC;YAChB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,cAAc,CAAC,GAAG,GAAG,CAAC;YACpE,CAAC,CAAC,IAAI;KACX,CAAC,CAAC,CAAC;AACN,CAAC"}
+{"version":3,"file":"tiers.js","sourceRoot":"","sources":["../../src/pricing/tiers.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAkB,EAAE,QAAgB;IACrE,IAAI,CAAC,KAAK,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAE/B,IAAI,OAAO,GAAqB,IAAI,CAAC;IACrC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,QAAQ,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACjC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;gBACvD,OAAO,GAAG,IAAI,CAAC;YACjB,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAyB;IACxD,MAAM,KAAK,GAAG,OAAO,CAAC,UAAU,CAAC;IACjC,IAAI,CAAC,KAAK,EAAE,MAAM;QAAE,OAAO,EAAE,CAAC;IAE9B,MAAM,cAAc,GAAG,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,KAAK,CAAC;IAC5D,IAAI,cAAc,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IAEnC,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC1B,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,OAAO,EAAE,OAAO,CAAC,cAAc,EAAE,KAAK,IAAI,IAAI;QAC9C,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,iBAAiB,EACf,cAAc,GAAG,CAAC;YAChB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,cAAc,CAAC,GAAG,GAAG,CAAC;YACpE,CAAC,CAAC,IAAI;KACX,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/pricing/validation.d.ts

@@ -1,14 +1,69 @@
-import type { OrderValidationResult } from '../types.js';
+import type { OrderableStockInput, OrderValidationResult } from '../types.js';
+/**
+ * Validate an order against the channel's order minimums.
+ * Call before `transitionToArrangingPayment()` to provide early feedback.
+ *
+ * Pass the object from `getOrderConstraints()` straight through — its
+ * `minOrderAmountGross` / `minOrderQuantity` fields are read directly:
+ *
+ * ```ts
+ * const constraints = await client.checkout.getOrderConstraints();
+ * const result = client.pricing.validateOrderMinimums(order, constraints);
+ * ```
+ *
+ * The server enforces both minimums at the transition regardless, and its
+ * message may name the price list that binds ("Minimum order for Wholesale
+ * is …"), which the client cannot know. Display the server's message as-is on
+ * failure; these messages are for the pre-checkout shortfall hint.
+ */
 export declare function validateOrderMinimums(order: {
     totalWithTax: number;
     currencyCode: string;
     totalQuantity?: number;
+    /**
+     * Net (tax-exclusive) total, minor units. Only needed when the channel
+     * returns `minOrderAmountNet`; `subTotal` is preferred over `total` because
+     * the server compares line totals, which exclude shipping.
+     */
     subTotal?: number;
     total?: number;
 }, constraints: {
+    /** Minimum vs the GROSS order total, minor units. As returned by `getOrderConstraints()`. */
     minOrderAmountGross?: number | null;
+    /**
+     * Minimum vs the NET order total, minor units. Independent of the gross
+     * minimum — both bind. As returned by `getOrderConstraints()`.
+     */
     minOrderAmountNet?: number | null;
+    /** Minimum total item count. As returned by `getOrderConstraints()`. */
     minOrderQuantity?: number | null;
+    /** @deprecated Use `minOrderAmountGross` — the field `getOrderConstraints()` actually returns. */
     minOrderAmount?: number | null;
 }): OrderValidationResult;
+export type { OrderableStockInput };
+/**
+ * How many units of a variant the current shopper may put in the cart:
+ * `max(0, saleable) + backorderAllowance`.
+ *
+ * Returns `null` when the channel does not expose stock (`saleable == null`) —
+ * the storefront cannot know a ceiling then and should let the server decide,
+ * exactly as before backorders existed. A `null` allowance counts as 0, so a
+ * shopper the policy does not admit gets plain `saleable`.
+ */
+export declare function maxOrderableQuantity(variant: OrderableStockInput): number | null;
+/**
+ * Whether a variant is orderable only on backorder: nothing saleable, but an
+ * allowance. The signal to label "Backorder" instead of "Out of stock".
+ */
+export declare function isBackorderOnly(variant: OrderableStockInput): boolean;
+/**
+ * Units of a cart line physical stock will not cover — the "N on backorder"
+ * hint BEFORE placement, when `backorderedQuantity` is still 0 — computed the
+ * way the server stamps it at placement: `max(0, quantity − max(0, saleable))`.
+ *
+ * `null` when there is nothing to say: the channel hides stock
+ * (`saleable == null` — never read that as 0, or every in-stock line would
+ * be "on backorder"), or stock covers the line. Pass the line's variant.
+ */
+export declare function backorderedQuantityForCart(variant: Pick<OrderableStockInput, 'saleable'>, quantity: number): number | null;
 //# sourceMappingURL=validation.d.ts.map

package/dist/pricing/validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/pricing/validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAwB,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAoB/E,wBAAgB,qBAAqB,CACnC,KAAK,EAAE;IACL,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IAMvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,EACD,WAAW,EAAE;IAEX,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAKpC,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAElC,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEjC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC,GACA,qBAAqB,CAgDvB"}
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/pricing/validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAwB,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAGpG;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE;IACL,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,EACD,WAAW,EAAE;IACX,6FAA6F;IAC7F,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,wEAAwE;IACxE,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,kGAAkG;IAClG,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC,GACA,qBAAqB,CAgDvB;AAED,YAAY,EAAE,mBAAmB,EAAE,CAAC;AAEpC;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,GAAG,IAAI,CAGhF;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAErE;AAED;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,IAAI,CAAC,mBAAmB,EAAE,UAAU,CAAC,EAC9C,QAAQ,EAAE,MAAM,GACf,MAAM,GAAG,IAAI,CAIf"}

package/dist/pricing/validation.js

@@ -1,4 +1,21 @@
 import { formatPrice } from './format.js';
+/**
+ * Validate an order against the channel's order minimums.
+ * Call before `transitionToArrangingPayment()` to provide early feedback.
+ *
+ * Pass the object from `getOrderConstraints()` straight through — its
+ * `minOrderAmountGross` / `minOrderQuantity` fields are read directly:
+ *
+ * ```ts
+ * const constraints = await client.checkout.getOrderConstraints();
+ * const result = client.pricing.validateOrderMinimums(order, constraints);
+ * ```
+ *
+ * The server enforces both minimums at the transition regardless, and its
+ * message may name the price list that binds ("Minimum order for Wholesale
+ * is …"), which the client cannot know. Display the server's message as-is on
+ * failure; these messages are for the pre-checkout shortfall hint.
+ */
 export function validateOrderMinimums(order, constraints) {
     const errors = [];
     const minAmount = constraints.minOrderAmountGross ?? constraints.minOrderAmount;
@@ -10,17 +27,25 @@ export function validateOrderMinimums(order, constraints) {
             actual: order.totalWithTax,
         });
     }
+    // A net minimum is checked separately, never folded into the gross one: the
+    // two are different bases and converting between them needs a tax rate the
+    // client does not have. Both can fail on the same cart.
     const minAmountNet = constraints.minOrderAmountNet;
     const netTotal = order.subTotal ?? order.total;
     if (minAmountNet != null && minAmountNet > 0 && netTotal != null && netTotal < minAmountNet) {
         errors.push({
             type: 'min_amount',
+            // Says "excl. tax" so the figure is not read against the gross total the
+            // buyer sees on screen, where it would look wrong.
             message: `Minimum order amount is ${formatPrice(minAmountNet, order.currencyCode)} excl. tax`,
             required: minAmountNet,
             actual: netTotal,
         });
     }
     const minQuantity = constraints.minOrderQuantity;
+    // `totalQuantity` is optional so a caller passing only totals still validates
+    // the amount. Skipping the quantity check when it is absent is correct;
+    // silently failing it against `undefined` would not be.
     if (minQuantity != null &&
         minQuantity > 0 &&
         order.totalQuantity != null &&
@@ -34,4 +59,40 @@ export function validateOrderMinimums(order, constraints) {
     }
     return { valid: errors.length === 0, errors };
 }
+/**
+ * How many units of a variant the current shopper may put in the cart:
+ * `max(0, saleable) + backorderAllowance`.
+ *
+ * Returns `null` when the channel does not expose stock (`saleable == null`) —
+ * the storefront cannot know a ceiling then and should let the server decide,
+ * exactly as before backorders existed. A `null` allowance counts as 0, so a
+ * shopper the policy does not admit gets plain `saleable`.
+ */
+export function maxOrderableQuantity(variant) {
+    if (variant.saleable == null)
+        return null;
+    return Math.max(0, variant.saleable) + Math.max(0, variant.backorderAllowance ?? 0);
+}
+/**
+ * Whether a variant is orderable only on backorder: nothing saleable, but an
+ * allowance. The signal to label "Backorder" instead of "Out of stock".
+ */
+export function isBackorderOnly(variant) {
+    return (variant.saleable ?? 0) <= 0 && (variant.backorderAllowance ?? 0) > 0;
+}
+/**
+ * Units of a cart line physical stock will not cover — the "N on backorder"
+ * hint BEFORE placement, when `backorderedQuantity` is still 0 — computed the
+ * way the server stamps it at placement: `max(0, quantity − max(0, saleable))`.
+ *
+ * `null` when there is nothing to say: the channel hides stock
+ * (`saleable == null` — never read that as 0, or every in-stock line would
+ * be "on backorder"), or stock covers the line. Pass the line's variant.
+ */
+export function backorderedQuantityForCart(variant, quantity) {
+    if (variant.saleable == null)
+        return null;
+    const units = Math.max(0, quantity - Math.max(0, variant.saleable));
+    return units > 0 ? units : null;
+}
 //# sourceMappingURL=validation.js.map

package/dist/pricing/validation.js.map

@@ -1 +1 @@
-{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/pricing/validation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAmB1C,MAAM,UAAU,qBAAqB,CACnC,KAWC,EACD,WAYC;IAED,MAAM,MAAM,GAA2B,EAAE,CAAC;IAE1C,MAAM,SAAS,GAAG,WAAW,CAAC,mBAAmB,IAAI,WAAW,CAAC,cAAc,CAAC;IAChF,IAAI,SAAS,IAAI,IAAI,IAAI,SAAS,GAAG,CAAC,IAAI,KAAK,CAAC,YAAY,GAAG,SAAS,EAAE,CAAC;QACzE,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,YAAY;YAClB,OAAO,EAAE,2BAA2B,WAAW,CAAC,SAAS,EAAE,KAAK,CAAC,YAAY,CAAC,EAAE;YAChF,QAAQ,EAAE,SAAS;YACnB,MAAM,EAAE,KAAK,CAAC,YAAY;SAC3B,CAAC,CAAC;IACL,CAAC;IAKD,MAAM,YAAY,GAAG,WAAW,CAAC,iBAAiB,CAAC;IACnD,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,KAAK,CAAC;IAC/C,IAAI,YAAY,IAAI,IAAI,IAAI,YAAY,GAAG,CAAC,IAAI,QAAQ,IAAI,IAAI,IAAI,QAAQ,GAAG,YAAY,EAAE,CAAC;QAC5F,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,YAAY;YAGlB,OAAO,EAAE,2BAA2B,WAAW,CAAC,YAAY,EAAE,KAAK,CAAC,YAAY,CAAC,YAAY;YAC7F,QAAQ,EAAE,YAAY;YACtB,MAAM,EAAE,QAAQ;SACjB,CAAC,CAAC;IACL,CAAC;IAED,MAAM,WAAW,GAAG,WAAW,CAAC,gBAAgB,CAAC;IAIjD,IACE,WAAW,IAAI,IAAI;QACnB,WAAW,GAAG,CAAC;QACf,KAAK,CAAC,aAAa,IAAI,IAAI;QAC3B,KAAK,CAAC,aAAa,GAAG,WAAW,EACjC,CAAC;QACD,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,cAAc;YACpB,OAAO,EAAE,6BAA6B,WAAW,QAAQ;YACzD,QAAQ,EAAE,WAAW;YACrB,MAAM,EAAE,KAAK,CAAC,aAAa;SAC5B,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;AAChD,CAAC"}
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/pricing/validation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,qBAAqB,CACnC,KAWC,EACD,WAYC;IAED,MAAM,MAAM,GAA2B,EAAE,CAAC;IAE1C,MAAM,SAAS,GAAG,WAAW,CAAC,mBAAmB,IAAI,WAAW,CAAC,cAAc,CAAC;IAChF,IAAI,SAAS,IAAI,IAAI,IAAI,SAAS,GAAG,CAAC,IAAI,KAAK,CAAC,YAAY,GAAG,SAAS,EAAE,CAAC;QACzE,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,YAAY;YAClB,OAAO,EAAE,2BAA2B,WAAW,CAAC,SAAS,EAAE,KAAK,CAAC,YAAY,CAAC,EAAE;YAChF,QAAQ,EAAE,SAAS;YACnB,MAAM,EAAE,KAAK,CAAC,YAAY;SAC3B,CAAC,CAAC;IACL,CAAC;IAED,4EAA4E;IAC5E,2EAA2E;IAC3E,wDAAwD;IACxD,MAAM,YAAY,GAAG,WAAW,CAAC,iBAAiB,CAAC;IACnD,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,KAAK,CAAC;IAC/C,IAAI,YAAY,IAAI,IAAI,IAAI,YAAY,GAAG,CAAC,IAAI,QAAQ,IAAI,IAAI,IAAI,QAAQ,GAAG,YAAY,EAAE,CAAC;QAC5F,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,YAAY;YAClB,yEAAyE;YACzE,mDAAmD;YACnD,OAAO,EAAE,2BAA2B,WAAW,CAAC,YAAY,EAAE,KAAK,CAAC,YAAY,CAAC,YAAY;YAC7F,QAAQ,EAAE,YAAY;YACtB,MAAM,EAAE,QAAQ;SACjB,CAAC,CAAC;IACL,CAAC;IAED,MAAM,WAAW,GAAG,WAAW,CAAC,gBAAgB,CAAC;IACjD,8EAA8E;IAC9E,wEAAwE;IACxE,wDAAwD;IACxD,IACE,WAAW,IAAI,IAAI;QACnB,WAAW,GAAG,CAAC;QACf,KAAK,CAAC,aAAa,IAAI,IAAI;QAC3B,KAAK,CAAC,aAAa,GAAG,WAAW,EACjC,CAAC;QACD,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,cAAc;YACpB,OAAO,EAAE,6BAA6B,WAAW,QAAQ;YACzD,QAAQ,EAAE,WAAW;YACrB,MAAM,EAAE,KAAK,CAAC,aAAa;SAC5B,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;AAChD,CAAC;AAID;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAA4B;IAC/D,IAAI,OAAO,CAAC,QAAQ,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IAC1C,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,kBAAkB,IAAI,CAAC,CAAC,CAAC;AACtF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,OAA4B;IAC1D,OAAO,CAAC,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,kBAAkB,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;AAC/E,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,0BAA0B,CACxC,OAA8C,EAC9C,QAAgB;IAEhB,IAAI,OAAO,CAAC,QAAQ,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IACpE,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAClC,CAAC"}

package/dist/redirects/index.d.ts

@@ -1,5 +1,6 @@
 import type { StoreContext } from '../types.js';
 import type { RedirectStore, RedirectStoreConfig } from './types.js';
+/** Wire a redirect store from an initialized client's context. */
 export declare function createRedirectsModule(ctx: StoreContext, options?: Pick<RedirectStoreConfig, 'ttlMs' | 'timeoutMs' | 'onError'>): RedirectStore;
 export { createRedirectStore, normalizeLookupPath } from './store.js';
 export { REDIRECT_STATUS_CODES, type RedirectMatch, type RedirectRule, type RedirectSnapshot, type RedirectStatusCode, type RedirectStore, type RedirectStoreConfig, } from './types.js';

package/dist/redirects/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/redirects/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAGrE,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,YAAY,EACjB,OAAO,CAAC,EAAE,IAAI,CAAC,mBAAmB,EAAE,OAAO,GAAG,WAAW,GAAG,SAAS,CAAC,GACrE,aAAa,CAOf;AAED,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,EACL,qBAAqB,EACrB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,mBAAmB,GACzB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/redirects/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAErE,kEAAkE;AAClE,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,YAAY,EACjB,OAAO,CAAC,EAAE,IAAI,CAAC,mBAAmB,EAAE,OAAO,GAAG,WAAW,GAAG,SAAS,CAAC,GACrE,aAAa,CAOf;AAED,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,EACL,qBAAqB,EACrB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,mBAAmB,GACzB,MAAM,YAAY,CAAC"}

package/dist/redirects/index.js

@@ -1,4 +1,5 @@
 import { createRedirectStore } from './store.js';
+/** Wire a redirect store from an initialized client's context. */
 export function createRedirectsModule(ctx, options) {
     return createRedirectStore({
         storeCode: ctx.channel.code,

package/dist/redirects/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/redirects/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAIjD,MAAM,UAAU,qBAAqB,CACnC,GAAiB,EACjB,OAAsE;IAEtE,OAAO,mBAAmB,CAAC;QACzB,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,IAAI;QAC3B,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,GAAG,OAAO;KACX,CAAC,CAAC;AACL,CAAC;AAED,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,EACL,qBAAqB,GAOtB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/redirects/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAGjD,kEAAkE;AAClE,MAAM,UAAU,qBAAqB,CACnC,GAAiB,EACjB,OAAsE;IAEtE,OAAO,mBAAmB,CAAC;QACzB,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,IAAI;QAC3B,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,GAAG,OAAO;KACX,CAAC,CAAC;AACL,CAAC;AAED,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,EACL,qBAAqB,GAOtB,MAAM,YAAY,CAAC"}

package/dist/redirects/store.d.ts

@@ -1,4 +1,24 @@
+/**
+ * In-process redirect map for a storefront.
+ *
+ * Fetches the platform's public per-channel snapshot once per TTL and matches
+ * pathnames against it in memory, so a middleware costs a Map lookup rather
+ * than a network hop. Revalidation is ETag-conditional: an unchanged map comes
+ * back as a 304 with no body.
+ *
+ * Deliberately fail-open — a refresh failure keeps the last good map in service
+ * and reports through `onError` rather than throwing. A platform blip must not
+ * turn a tenant's working redirects into 404s.
+ *
+ * Only the FIRST load is awaited. Once a map exists, revalidation happens in the
+ * background and callers are served the current one: this runs in middleware
+ * ahead of every page render, so a slow platform must never become a slow store.
+ */
 import { type RedirectStore, type RedirectStoreConfig } from './types.js';
+/**
+ * Match the platform's own source normalization: trailing slashes are stripped
+ * so `/a` and `/a/` are the same rule. The root path keeps its slash.
+ */
 export declare function normalizeLookupPath(pathname: string): string;
 export declare function createRedirectStore(config: RedirectStoreConfig): RedirectStore;
 //# sourceMappingURL=store.d.ts.map

package/dist/redirects/store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/redirects/store.ts"],"names":[],"mappings":"AAkBA,OAAO,EAML,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACzB,MAAM,YAAY,CAAC;AA2BpB,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAe5D;AAsCD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,GAAG,aAAa,CA+J9E"}
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/redirects/store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAML,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACzB,MAAM,YAAY,CAAC;AAuBpB;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAe5D;AAsCD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,GAAG,aAAa,CA+J9E"}