@liquidcommerce/elements-sdk 2.6.0-beta.130 → 2.6.0-beta.132

package/dist/types/core/api/api-result.d.ts

@@ -2,6 +2,8 @@ export interface IApiErrorDetail {
     field?: string;
     message: string;
     code?: string;
+    retailerId?: string;
+    fulfillmentId?: string;
 }
 export interface ApiError {
     status: number;

package/dist/types/core/store/interfaces/checkout.interface.d.ts

@@ -1,5 +1,5 @@
 import type { ICheckoutAmounts, ICheckoutBilling, ICheckoutCustomer, ICheckoutEvent, ICheckoutFulfillment, ICheckoutFulfillmentMethod, ICheckoutGiftCard, ICheckoutGiftRecipient, ICheckoutItem, ICheckoutMarketingPreferences, ICheckoutPaymentConfirm, ICheckoutPaymentSession, ICheckoutPresale, ICheckoutPromoCode, ICheckoutRetailer, ICheckoutShippingAddress } from '@/interfaces/api/checkout.interface';
-export type DeliveryWindowLapse = 'expired' | 'unavailable';
+export type DeliveryWindowLapse = 'expired' | 'unavailable' | 'required';
 export interface ICheckoutItemStore extends ICheckoutItem {
     loading: boolean;
     updating: boolean;
@@ -67,6 +67,7 @@ export interface ICheckoutStore {
     fulfillments: Record<string, ICheckoutFulfillment>;
     deliveryWindowLapses: Record<string, DeliveryWindowLapse>;
     deliveryScheduleNotice: string | null;
+    splitStoreDeliveryRefused: boolean;
     retailers: Record<string, ICheckoutRetailer>;
     amounts: ICheckoutAmounts;
     orderNumber: string | null;

package/dist/types/interfaces/api/cart.interface.d.ts

@@ -1,5 +1,6 @@
 import type { CartEventLevel, CartEventType, FulfillmentType } from '@/enums';
 import type { ILocation } from '@/interfaces/api/address.interface';
+import type { DeliveryAvailability } from '@/interfaces/api/delivery.interface';
 import type { IProductPresale } from '@/interfaces/api/product.interface';
 export interface ICartUpdateItem {
     id?: string;
@@ -24,6 +25,7 @@ export interface ICartFulfillment {
     subtotal: number;
     hasUnmetMinimumPurchaseAmount: boolean;
     minimumPurchaseAmount: number;
+    deliveryAvailability?: DeliveryAvailability;
 }
 export interface ICartRetailer {
     id: string;

package/dist/types/interfaces/api/checkout.interface.d.ts

@@ -1,7 +1,7 @@
 import type { CheckoutEventLevel, CheckoutEventType, FulfillmentType } from '@/enums';
 import type { IAddressAddress, IAddressCoordinates, ILocation } from '@/interfaces/api/address.interface';
 import type { ICart, ICartUpdateItem } from '@/interfaces/api/cart.interface';
-import type { CheckoutDeliveryScheduling, CheckoutDeliverySelection } from '@/interfaces/api/delivery.interface';
+import type { CheckoutDeliveryScheduling, CheckoutDeliverySelection, DeliveryAvailability } from '@/interfaces/api/delivery.interface';
 import type { IProductPresale } from '@/interfaces/api/product.interface';
 export interface ICheckoutComplete {
     orderNumber: string;
@@ -99,6 +99,7 @@ export interface ICheckoutItemsUpdateParams {
     cartId: string;
     items: ICheckoutUpdateItem[];
     location?: ILocation;
+    checkout?: ICheckoutFulfillmentCarryOver;
 }
 export interface ICheckoutItemsUpdateResponse {
     cart: ICart;
@@ -137,6 +138,7 @@ export interface ICheckoutFulfillmentMethod {
     partNumber: string;
     retailerId: string;
     reason: CheckoutFulfillmentUnavailableReason | null;
+    deliveryAvailability?: DeliveryAvailability;
 }
 export type ICheckoutFulfillmentCarryOver = Omit<ICheckoutPrepareParams, 'cartId' | 'token' | 'deliveryTips' | 'deliveryInstructions' | 'deliverySelections' | 'deliverySlotsFulfillmentId'>;
 export interface ICheckoutFulfillmentParams {

package/dist/types/interfaces/api/product.interface.d.ts

@@ -1,5 +1,6 @@
 import type { FulfillmentType } from '@/enums';
 import type { IAddressAddress, IAddressCoordinates, ILocation } from '@/interfaces/api/address.interface';
+import type { DeliveryAvailability } from '@/interfaces/api/delivery.interface';
 export interface IProductAvailabilityParams {
     identifiers: string[];
     location?: ILocation;
@@ -83,6 +84,7 @@ export interface IFulfillment {
     fee: number;
     timezone: string;
     hourStatus: IProductFulfillmentHourStatus;
+    deliveryAvailability?: DeliveryAvailability;
 }
 export type IRetailerAddress = IAddressAddress & IAddressCoordinates;
 export interface IRetailer {

package/dist/types/modules/cart/components/cart-item.component.d.ts

@@ -1,7 +1,9 @@
 import { BaseComponent } from '@/core/base-component.service';
+import type { ICartFulfillmentStore } from '@/core/store/interfaces/cart.interface';
 export interface ICartItemComponentParams {
     itemId: string;
 }
+export declare function cartItemExpectationText(fulfillment: ICartFulfillmentStore, hasEngraving: boolean): string;
 export declare class CartItemComponent extends BaseComponent<ICartItemComponentParams, null> {
     get hostClasses(): string[];
     get hostAttributes(): Record<string, string>;

package/dist/types/modules/checkout/checkout.commands.d.ts

@@ -36,8 +36,11 @@ export declare class CheckoutCommands extends BaseCommand {
     private findOfferedDeliverySlot;
     loadDeliverySlots(fulfillmentId: string): Promise<DeliverySlot[]>;
     chooseDeliverySlot(fulfillmentId: string, slotId: string | null): Promise<void>;
+    private deliverySelectionError;
     private completionError;
+    private freshCart;
     private dropDeliveryScheduling;
+    private lapsedWindowGroupIds;
     private forgetDeliveryWindow;
     private assertDeliverySlotChoosable;
     private responseFulfillments;
@@ -47,7 +50,11 @@ export declare class CheckoutCommands extends BaseCommand {
     private expiredDeliveryMarksWith;
     private pruneExpiredDeliveryWindows;
     private expireDeliveryWindows;
+    private requestPrepare;
+    private withStoreNamedFailure;
+    private knownRetailers;
     private prepareWithWindowRecovery;
+    private prepareRecoveringWindow;
     retryLoadCheckout(): Promise<void>;
     private paymentSessionRequest;
     constructor();
@@ -152,6 +159,8 @@ export declare class CheckoutCommands extends BaseCommand {
     private deliveryMethodCarryOver;
     private refreshPaymentAfterDeliveryMethodSwitch;
     changeDeliveryLocation(trigger?: HTMLElement | null): void;
+    private updateItemsOnCheckout;
+    private static lostCustomer;
     private syncFromItemUpdate;
     private syncCheckoutState;
     private refreshCheckout;

package/dist/types/modules/checkout/components/checkout-completed.component.d.ts

@@ -1,6 +1,6 @@
 import { BaseComponent } from '@/core/base-component.service';
 import type { ICheckoutComponent } from '@/interfaces/configs';
-import type { PlacedDeliveryWindow } from '@/utils/delivery-scheduling';
+import type { PlacedDelivery } from '@/utils/delivery-scheduling';
 export interface ICheckoutCompletedComponentParams {
     orderNumber: string;
     orderTotal: number;
@@ -10,11 +10,13 @@ export interface ICheckoutCompletedComponentParams {
     checkoutToken?: string;
     cartId?: string;
     isCompleted?: boolean;
-    deliveryWindows?: PlacedDeliveryWindow[];
+    delivery?: PlacedDelivery;
 }
 export declare class CheckoutCompletedComponent extends BaseComponent<ICheckoutCompletedComponentParams, ICheckoutComponent> {
     get hostClasses(): string[];
     private hasAnnouncedCompletion;
     protected afterRender(): void;
+    private createDeliveryLine;
+    private createDeliveryGroup;
     protected template(): HTMLElement[];
 }

package/dist/types/modules/checkout/components/checkout-delivery-method.component.d.ts

@@ -1,5 +1,7 @@
 import { BaseComponent } from '@/core/base-component.service';
+import type { ICheckoutFulfillmentMethod } from '@/interfaces/api/checkout.interface';
 import type { ICheckoutComponent } from '@/interfaces/configs';
+export declare function deliveryMethodExpectationText(method: ICheckoutFulfillmentMethod): string;
 export declare class CheckoutDeliveryMethodComponent extends BaseComponent<null, ICheckoutComponent> {
     get hostClasses(): string[];
     constructor();

package/dist/types/modules/checkout/components/checkout-delivery-scheduling.component.d.ts

@@ -36,7 +36,9 @@ export declare class CheckoutDeliverySchedulingComponent extends BaseComponent<n
     private closePicker;
     private saveDraft;
     private createGroup;
-    private get schedulingAllowed();
+    private get severalGroups();
+    private retailerOf;
+    private pickerTitle;
     private summaryText;
     private radio;
     private createDates;

package/dist/types/modules/checkout/components/checkout-payment.component.d.ts

@@ -30,6 +30,7 @@ export declare class CheckoutPaymentComponent extends BaseComponent<ICheckoutSen
     private lastAnnouncedPaymentError;
     private updateErrorMessage;
     private showError;
+    private createHeader;
     protected template(): HTMLElement[];
     private handleSaveButtonClick;
     private validatePrerequisites;

package/dist/types/utils/delivery-scheduling.d.ts

@@ -1,24 +1,35 @@
 import type { ApiError } from '@/core/api/api-result';
 import type { DeliveryWindowLapse } from '@/core/store/interfaces/checkout.interface';
 import type { StoreService } from '@/core/store/store.service';
-import type { ICheckoutFulfillment, ICheckoutRetailer, ICheckoutShippingAddress } from '@/interfaces/api/checkout.interface';
+import { type FulfillmentType } from '@/enums';
+import type { ICart } from '@/interfaces/api/cart.interface';
+import type { ICheckoutFulfillment, ICheckoutItem, ICheckoutRetailer, ICheckoutShippingAddress } from '@/interfaces/api/checkout.interface';
 import type { CheckoutDeliveryScheduling, DeliverySlot } from '@/interfaces/api/delivery.interface';
+import type { IFulfillment } from '@/interfaces/api/product.interface';
 export declare const LAPSED_DELIVERY_WINDOW_CODES: readonly string[];
 export declare const DELIVERY_WINDOW_EXPIRED_MESSAGE = "Your delivery window has passed. Choose a new delivery time.";
 export declare const DELIVERY_WINDOW_UNAVAILABLE_MESSAGE = "Your delivery window is no longer available. Choose a new delivery time.";
+export declare const DELIVERY_WINDOW_REQUIRED_MESSAGE = "The store cannot deliver now. Choose a delivery time.";
 export declare const UNSUPPORTED_DELIVERY_SCHEDULING_CODES: readonly string[];
 export declare const DELIVERY_SELECTION_NOT_ACCEPTED_CODE = "delivery_selection_not_accepted";
 export declare const DELIVERY_SELECTION_NOT_ACCEPTED_MESSAGE = "We couldn't save that delivery time. Choose a delivery time again.";
 export declare const SAVED_DELIVERY_WINDOW_LABEL = "Scheduled delivery";
 export declare const DELIVERY_SCHEDULING_UNAVAILABLE_MESSAGE = "Scheduled delivery isn't available for this order right now. We'll deliver as soon as possible.";
+export declare const MULTIPLE_FULFILLMENT_OPTIONS_PER_STORE_CODE = "multiple_fulfillment_options_per_store";
+export declare const MULTIPLE_FULFILLMENT_OPTIONS_PER_STORE_MESSAGE = "Scheduled delivery cannot be combined with another delivery method from the same store. Choose ASAP delivery, or use one delivery method for all items from this store.";
+export declare const CLOSED_STORE_MULTIPLE_FULFILLMENT_OPTIONS_MESSAGE = "This store is closed now. Use one delivery method for all items from this store.";
+export declare function splitStoreRefusalMessage(store: Pick<StoreService, 'get'>): string;
+export declare function freshCartSplitStoreRefusalMessage(cart: Pick<ICart, 'retailers'>): string;
 export declare function expiredDeliveryFulfillmentIds(store: Pick<StoreService, 'get'>): string[];
 export declare function deliveryWindowLapseOf(error: Pick<ApiError, 'errors'> | null | undefined): DeliveryWindowLapse;
 export type DeliveryWindowLapseText = 'message' | 'label';
 export declare function deliveryWindowLapseMessage(lapse: DeliveryWindowLapse | null | undefined, text?: DeliveryWindowLapseText): string;
 export declare function lapsedDeliveryWindowMessage(store: Pick<StoreService, 'get'>, fulfillmentId: string, text?: DeliveryWindowLapseText): string;
 export declare function withoutDeliveryWindow(fulfillment: ICheckoutFulfillment): ICheckoutFulfillment;
+export declare function deliveryErrorFulfillmentIds(error: Pick<ApiError, 'errors'> | null | undefined): string[];
 export declare function isLapsedDeliveryWindowError(error: Pick<ApiError, 'errors'> | null | undefined): boolean;
 export declare function isNotAcceptedDeliverySelectionError(error: Pick<ApiError, 'errors'> | null | undefined): boolean;
+export declare function isMultipleFulfillmentOptionsPerStoreError(error: Pick<ApiError, 'errors'> | null | undefined): boolean;
 export declare function isUnsupportedDeliverySchedulingError(error: Pick<ApiError, 'errors'> | null | undefined): boolean;
 export declare function deliveryAddressKey(address: ICheckoutShippingAddress | null | undefined): string;
 export declare function isFutureDeliverySlot(slot: DeliverySlot | null | undefined, now?: number): boolean;
@@ -27,17 +38,35 @@ export declare function isLapsedSelectedDeliverySlot(scheduling: CheckoutDeliver
 export declare function deliverySchedulesReady(fulfillments: Record<string, ICheckoutFulfillment>, now?: number, expired?: string[]): boolean;
 export declare function deliveryChoicesMade(fulfillments: Record<string, ICheckoutFulfillment>, expired?: string[]): boolean;
 export declare function hasDeliveryScheduling(fulfillments: Record<string, ICheckoutFulfillment> | null | undefined): boolean;
-export declare function deliverySchedulingAllowed(fulfillments: Record<string, ICheckoutFulfillment> | null | undefined): boolean;
+export declare function retailerOfFulfillment(retailers: Record<string, ICheckoutRetailer> | null | undefined, fulfillmentId: string): ICheckoutRetailer | undefined;
+export declare function deliveryWindowNeededMessage(store: Pick<StoreService, 'get'>, fulfillmentIds: string[]): string;
+export declare function hasSeveralDeliveryGroups(fulfillments: Record<string, ICheckoutFulfillment> | null | undefined): boolean;
 export declare function deliveryTimeZone(timezone: string | null | undefined): string;
+export declare function deliveryDateTimeFormat(timezone: string, options: Omit<Intl.DateTimeFormatOptions, 'timeZone'>): Intl.DateTimeFormat;
 export declare function deliveryDateLabel(slot: DeliverySlot, timezone: string): string;
 export declare function deliveryTimeZoneName(timezone: string, style?: 'short' | 'long'): string;
 export declare function deliveryTimeLabel(slot: DeliverySlot, timezone: string): string;
 export declare function deliveryWindowLabel(slot: DeliverySlot, timezone: string): string;
 export declare function deliveryScheduledLabel(slot: DeliverySlot, timezone: string): string;
 export declare function deliveryCutoffLabel(slot: DeliverySlot, timezone: string): string;
-export interface PlacedDeliveryWindow {
-    retailerName: string | null;
+export interface PlacedDeliveryLine {
+    heading: string;
     label: string;
 }
-export declare function placedDeliveryWindows(fulfillments: Record<string, ICheckoutFulfillment> | null | undefined, retailers: Record<string, ICheckoutRetailer> | null | undefined): PlacedDeliveryWindow[];
+export interface PlacedDelivery {
+    perGroup: boolean;
+    lines: PlacedDeliveryLine[];
+}
+export declare function placedDeliveryLines(fulfillments: Record<string, ICheckoutFulfillment> | null | undefined, retailers: Record<string, ICheckoutRetailer> | null | undefined, items?: Record<string, ICheckoutItem> | null): PlacedDelivery;
+type FulfillmentAvailability = Pick<IFulfillment, 'hourStatus' | 'deliveryAvailability'>;
+type SchedulingAvailability = Pick<IFulfillment, 'deliveryAvailability'>;
+export declare function deliversNow(fulfillment: FulfillmentAvailability): boolean;
+export declare function takesOrdersForLater(fulfillment: SchedulingAvailability, now?: number): boolean;
+export declare function nextScheduledDeliverySlot(fulfillment: SchedulingAvailability, now?: number): DeliverySlot | null;
+export declare function isDeliveryPurchasable(fulfillment: FulfillmentAvailability, now?: number): boolean;
+export declare function isOnDemandUnpurchasable(type: FulfillmentType, fulfillment: FulfillmentAvailability): boolean;
+export declare function preferredOnDemandFulfillment<T extends FulfillmentAvailability>(fulfillments: T[], now?: number): T | undefined;
+export declare function nextArrivalLabel(fulfillment: SchedulingAvailability, now?: number): string | null;
+export declare function scheduleDeliveryText(fulfillment: SchedulingAvailability, now?: number): string | null;
 export declare function resolveDeliverySlot(scheduling: CheckoutDeliveryScheduling | undefined, advertised: DeliverySlot, now?: number): DeliverySlot | null;
+export {};

package/dist/types/utils/fulfillment-unavailable.d.ts

@@ -0,0 +1,8 @@
+import type { ApiError } from '@/core/api/api-result';
+export declare const FULFILLMENT_UNAVAILABLE_CODE = "fulfillment_unavailable";
+export interface FulfillmentRetailer {
+    id: string;
+    name: string;
+    fulfillments: Record<string, unknown>;
+}
+export declare function fulfillmentUnavailableMessage(error: Pick<ApiError, 'errors'> | null | undefined, retailers: FulfillmentRetailer[]): string | null;

package/docs/v1/api/actions/checkout-actions.md

@@ -461,7 +461,7 @@ Loads the full list of delivery windows for one fulfillment. Checkout prepare re
 chooseDeliverySlot(fulfillmentId: string, slotId: string | null): Promise<void>
 ```
 
-Saves a window from the last loaded list for one fulfillment, or `null` for as soon as possible (only when `availability.canDeliverNow` is true). The promise resolves after prepare accepts and echoes that exact selection. It rejects malformed arguments, unknown fulfillments, windows that were not offered, concurrent checkout updates, a checkout with more than one fulfillment group (only a checkout with one group can be scheduled) and server errors; a rejected save keeps the previously accepted choice, except after `delivery_selection_not_accepted` (below). Slot IDs come from the server; do not build them.
+Saves a window from the last loaded list for one fulfillment, or `null` for as soon as possible (only when `availability.canDeliverNow` is true). The promise resolves after prepare accepts and echoes that exact selection. It rejects malformed arguments, unknown fulfillments, windows that were not offered, concurrent checkout updates and server errors; a rejected save keeps the previously accepted choice, except after `delivery_selection_not_accepted` (below). Slot IDs come from the server; do not build them.
 
 `getDetails().deliveryScheduling[fulfillmentId]` returns the availability, the accepted `selectedSlotId` and `selectedSlot` (the accepted window's `start`, `end` and `cutoff`).
 
@@ -476,11 +476,13 @@ if (fulfillmentId) {
 
 ### Expired windows
 
-If a saved window's cutoff passes, or the store's hours or zone rules no longer allow it, before the order is placed, the server answers Place Order, or any other checkout update, with error code `delivery_window_expired` or `delivery_window_unavailable`. Both are recovered the same way; only the message differs ("Your delivery window has passed. Choose a new delivery time." or "Your delivery window is no longer available. Choose a new delivery time."). The SDK then clears the window, marks the fulfillment as needing a new choice, shows the message, opens the picker and blocks payment and Place Order until the shopper saves a new choice. An update that hit the error is sent once more without the window, so the shopper's change still applies. Customer, address, payment, tip and notes stay as they were. A custom UI recovers the same way: load the windows again and call `chooseDeliverySlot`.
+If a saved window's cutoff passes, or the store's hours or zone rules no longer allow it, before the order is placed, the server answers Place Order, or any other checkout update, with error code `delivery_window_expired` or `delivery_window_unavailable`. Place Order on a store that cannot deliver now with no saved window answers `delivery_window_required`. All three are recovered the same way; only the message differs ("Your delivery window has passed. Choose a new delivery time.", "Your delivery window is no longer available. Choose a new delivery time." or "The store cannot deliver now. Choose a delivery time."). The SDK then clears the window, marks the fulfillment as needing a new choice, shows the message, opens the picker and blocks payment and Place Order until the shopper saves a new choice. An update that hit the error is sent once more without the window, so the shopper's change still applies. Customer, address, payment, tip and notes stay as they were. A custom UI recovers the same way: load the windows again and call `chooseDeliverySlot`.
 
 If prepare did not keep the window that was sent (error code `delivery_selection_not_accepted`, HTTP 409), the SDK drops the window it holds for that fulfillment so no later update sends it again. `chooseDeliverySlot` rejects with "We couldn't save that delivery time. Choose a delivery time again."; on any other update the window is recovered as an unavailable one.
 
-When scheduled delivery stops applying to the order (`delivery_scheduling_not_enabled`, `delivery_windows_unsupported`, `multiple_fulfillment_groups` or `delivery_scheduling_unsupported`), the SDK drops the saved window with a re-prepare, keeps the rest of checkout and shows "Scheduled delivery isn't available for this order right now. We'll deliver as soon as possible." The picker does not open; the response no longer carries `deliveryScheduling`, so the delivery time row goes away. Switching the delivery method never carries a window over to the new fulfillment.
+If a store cannot fulfill the selected delivery method at all, pickup included (error code `fulfillment_unavailable`, for example a closed store that offers no delivery window, or no estimate for the address), the SDK shows "W & J Wines & Spirits cannot fulfill this order now. Choose another store or delivery method." in place of the server's message, on loading the checkout, on any checkout update, on Place Order and on the cart's go-to-checkout. The store name comes from the cart or the checkout; when neither names the store, the message starts with "A store in your cart". The error detail carries the LC `retailerId` and `fulfillmentId` of each refused selection, so a custom UI can point at the store the same way. When AccelPay returns no estimates at all, Cloud refuses every selection, so the message names every store in the cart, even when the cause is the address.
+
+When scheduled delivery stops applying to the order (`delivery_scheduling_not_enabled`, `delivery_windows_unsupported` or `delivery_scheduling_unsupported`, and `multiple_fulfillment_groups` from an older server that schedules one group only), the SDK drops the saved window with a re-prepare, keeps the rest of checkout and shows "Scheduled delivery isn't available for this order right now. We'll deliver as soon as possible." The picker does not open; the response no longer carries `deliveryScheduling`, so the delivery time row goes away. Switching the delivery method never carries a window over to the new fulfillment.
 
 ## Use Cases
 

package/docs/v1/api/actions/product-actions.md

@@ -155,6 +155,7 @@ interface IFulfillment {
   fee: number;
   timezone: string;
   hourStatus: { isOpen: boolean; openTime: string; isClosed: boolean; closeTime: string };
+  deliveryAvailability?: DeliveryAvailability; // same-day only, where the retailer schedules delivery
 }
 
 interface IProduct {

package/docs/v1/api/typescript-types.md

@@ -590,7 +590,7 @@ export interface DeliveryAvailability {
   canDeliverNow: boolean;
   canSchedule: boolean;
   timezone: string | null; // store IANA time zone; null when the server has none (the SDK then shows UTC)
-  nextSlot: DeliverySlot | null;
+  nextSlot: DeliverySlot | null; // null on a product fulfillment of a closed store: checkout gives the windows
   checkedAt: string;
 }
 

package/docs/v1/guides/accessibility.md

@@ -152,7 +152,10 @@ on render, and a live region recreated with its text already in place is not ann
 - An option in a single-select group carries its **whole** visible content in its accessible name.
   `option` and `radio` have presentational children, so the name is the only channel: a delivery
   option names the retailer, the price, the timing, the delivery fee and — for same-day — the
-  store address and whether it is currently closed.
+  store address and whether it is currently closed. A closed store that schedules delivery leads
+  with that instead ("Columbus Avenue Wines, closed now, schedule delivery"), followed by
+  "next arrival Thu, Oct 8, 1 PM – 2 PM ET" only when the server sends a next window; its card
+  stays enabled.
 - The California Proposition 65 warning on the product is a native `<details>` / `<summary>`
   disclosure: the summary is a button that exposes its expanded state, and `Enter` / `Space` toggle
   it with no scripting involved. Its `+` / `−` indicator is decorative and hidden. In checkout it is

package/docs/v1/guides/cart-component.md

@@ -14,6 +14,8 @@ The Cart component automatically:
 - Persists cart across sessions and tabs
 - Provides checkout navigation
 
+A same-day line from a store that is closed now but takes orders for later (its fulfillment's `deliveryAvailability` says it cannot deliver now and can schedule) shows "Schedule delivery" in place of the delivery estimate. The shopper chooses the delivery window in checkout.
+
 ## Basic Usage
 
 The cart is automatically available when using the SDK - no explicit injection needed for the drawer. However, you need a way for users to open it.

package/docs/v1/guides/checkout-component.md

@@ -909,8 +909,12 @@ fails, the shopper can retry or explicitly choose the visible channel preference
 
 When an AccelPay retailer has scheduled delivery turned on, checkout shows a **Delivery time** row for that delivery, between the delivery details and payment. It reads "As soon as possible" while the store can deliver now, or asks for a window when it cannot. The row's button reads **Schedule** while the row is on as soon as possible, **Edit** after a window is saved, and **Schedule delivery** when the shopper must choose a window. It opens a dialog that loads the windows for that delivery: date cards for today and the next 7 days, then arrival windows in the retailer's time zone, named once above the list ("Times in Eastern Time"). The window list scrolls inside the dialog and keeps the chosen window in view. The first window shows "Order by" with its cutoff, and **As soon as possible** sits next to it when the store can deliver now. Choices are drafts until **Save**; Cancel, Close and Escape discard them.
 
-The accepted window shows in the row and on the items in the order summary ("Scheduled for Thu, Oct 8, 1 PM – 2 PM ET"), and on the thank-you page as "Delivery time" with "Thu, Oct 8, 1 PM – 2 PM ET" (with more than one window, each line names its retailer). An ASAP order adds no line there. If the window's cutoff passes before the order is placed, the SDK clears it, shows "Your delivery window has passed. Choose a new delivery time.", reopens the picker and keeps Place Order disabled until a new choice is saved. If the store no longer offers the window, the same happens with "Your delivery window is no longer available. Choose a new delivery time." Everything else the shopper entered stays.
+The accepted window shows in the row and on the items in the order summary ("Scheduled for Thu, Oct 8, 1 PM – 2 PM ET"), and on the thank-you page as "Delivery time" with "Thu, Oct 8, 1 PM – 2 PM ET". An ASAP order adds no line there. If the window's cutoff passes before the order is placed, the SDK clears it, shows "Your delivery window has passed. Choose a new delivery time.", reopens the picker and keeps Place Order disabled until a new choice is saved. If the store no longer offers the window, the same happens with "Your delivery window is no longer available. Choose a new delivery time." Everything else the shopper entered stays.
 
-A checkout with more than one fulfillment group cannot be scheduled: the row reads "As soon as possible" with no picker button, and no window is asked for. While a store that cannot deliver now has no accepted window, the express wallet buttons stay off, like the card form.
+A store that was added to the cart while closed cannot deliver now, so checkout asks for a window and offers no ASAP. If a store closes after the shopper chose ASAP, Place Order answers `delivery_window_required`: the SDK shows "The store cannot deliver now. Choose a delivery time.", opens the picker and keeps Place Order disabled until a window is saved.
+
+In a checkout with more than one fulfillment group (another store, or shipping), each same-day group with scheduled delivery gets its own **Delivery time** row and its own picker, which loads that group's windows. Its button reads **Schedule this store's delivery** (**Edit** after a window is saved), and the picker is named after the store ("Schedule delivery from Columbus Avenue Wines"). Every prepare sends each group's current choice, so saving one group keeps the other's window. A group whose store can deliver now stays on as soon as possible; a group whose store cannot needs its own window before payment and Place Order. When a window lapses, only that group's window is cleared and only its picker reopens: the SDK clears the window whose cutoff passed on the page, and for `delivery_window_required` marks the groups that have no window. When an error names its group (`fulfillmentId` on the error entry), only that group is cleared; when it names none and the SDK cannot place it, every saved window is cleared. Until each store that cannot deliver now has a window, payment says which: "Choose a delivery window for Amsterdam Liquors before continuing." In an order with more than one fulfillment group, the thank-you page has one line per group, named after its store: the accepted window for a scheduled group ("Columbus Avenue Wines" with "Thu, Oct 8, 1 PM – 2 PM ET"), and the group's own expectation for the others ("Harbor Spirits" with "Ships in 3-5 days"). A scheduled group never shows the as-soon-as-possible expectation. While a store that cannot deliver now has no accepted window, the express wallet buttons stay off, like the card form. When checkout refuses a store that has scheduled delivery and also another delivery method (`multiple_fulfillment_options_per_store`, code 5516), the SDK shows the refusal as the checkout error and keeps the saved windows: "Scheduled delivery cannot be combined with another delivery method from the same store. Choose ASAP delivery, or use one delivery method for all items from this store." When that store is closed now, the text leaves out ASAP: "This store is closed now. Use one delivery method for all items from this store." When Place Order is refused, the SDK reads the cart again and decides "closed now" from its `deliveryAvailability`, because a store can close after the last prepare. Place Order and the express wallet stay off until a prepare succeeds after a change to the cart or to a delivery choice.
+
+In the delivery-method switch, a same-day method whose `deliveryAvailability` says the store cannot deliver now but can schedule shows "Schedule delivery" in place of its delivery estimate. Without `deliveryAvailability` the card shows the estimate as before.
 
 Checkouts without scheduled delivery are unchanged. For a custom UI, see `actions.checkout.loadDeliverySlots` and `actions.checkout.chooseDeliverySlot` in the checkout actions reference, and the `checkout_delivery_selection_updated` event.

package/docs/v1/guides/product-component.md

@@ -480,6 +480,12 @@ await window.LiquidCommerce.elements.actions.address.setAddressManually(
 );
 ```
 
+## Buying when a retailer is closed
+
+A same-day retailer whose store schedules delivery can take orders while it is closed. Its fulfillment then carries `deliveryAvailability`. When that says the store cannot deliver now but can schedule (`status: 'available'`, `canSchedule: true`), the retailer card stays on and shows "Schedule delivery". The product page shows no time: the server sends `nextSlot: null` for a closed store, and checkout asks the shopper to choose a delivery window. Add to Cart stays on. Screen readers hear "Columbus Avenue Wines, closed now, schedule delivery" in place of "Currently closed". When the server does send a `nextSlot`, the card adds it in the retailer's time zone ("Schedule delivery · Thu, Oct 8, 1 PM – 2 PM ET") and screen readers hear "…, next arrival Thu, Oct 8, 1 PM – 2 PM ET". The SDK selects a retailer that can deliver now first, then one that schedules delivery, and goes to shipping only when neither is available.
+
+A closed store without scheduled delivery is blocked as before. An unknown or unavailable `deliveryAvailability`, or a `nextSlot` whose order cutoff has passed, never turns purchase on.
+
 ## Presale Products
 
 Products in presale mode:

package/package.json

@@ -3,7 +3,7 @@
   "description": "LiquidCommerce Elements SDK",
   "license": "UNLICENSED",
   "author": "LiquidCommerce Team",
-  "version": "2.6.0-beta.130",
+  "version": "2.6.0-beta.132",
   "homepage": "https://docs.liquidcommerce.co/elements-sdk",
   "repository": {
     "type": "git",