@ikas/bp-storefront 2.8.0 → 2.9.1

package/dist/storefront-models/src/models/blueprint/prop-value/attribute.d.ts

@@ -1,6 +1,8 @@
+import { IBlueprintPropValueVariableBinding } from "./variable-binding";
 export interface IBlueprintAttributePropValue {
     productId?: string | null;
     variantId?: string | null;
     attributeId?: string | null;
     usePageData?: boolean | null;
+    productVariable?: IBlueprintPropValueVariableBinding | null;
 }

package/dist/storefront-models/src/models/blueprint/prop-value/index.d.ts

@@ -28,4 +28,5 @@ export * from "./rich-text";
 export * from "./svg";
 export * from "./svg-list";
 export * from "./text";
+export * from "./variable-binding";
 export * from "./video";

package/dist/storefront-models/src/models/blueprint/prop-value/variable-binding.d.ts

@@ -0,0 +1,16 @@
+/**
+ * A theme data binding stored INSIDE a prop value, so a single field of that value can follow a
+ * bound variable while the rest of the value stays statically authored (see
+ * `IBlueprintAttributePropValue.productVariable`). `key`/`variableId`/`path` mirror the editor's
+ * `IThemeVariableBinding` and `refId`/`componentId` mirror the surrounding `IThemeDynamicValueValue`
+ * context a COMPONENT_LIST child needs to resolve an ancestor's variable; duplicated here because
+ * storefront-models must not depend on editor-models. Only the editor and the code generators
+ * interpret it — the storefront runtime carries it through untouched.
+ */
+export interface IBlueprintPropValueVariableBinding {
+    key?: string | null;
+    variableId?: string | null;
+    path?: string[] | null;
+    refId?: string | null;
+    componentId?: string | null;
+}

package/dist/storefront-models/src/models/image/index.d.ts

@@ -1,5 +1,12 @@
 export type IkasImage = {
     id: string;
+    /**
+     * True when this media item is a VIDEO, not an image. Product media sets routinely mix both.
+     * getDefaultSrc/getSrc/getThumbnailSrc then return an .mp4 URL, so rendering it in an <img>
+     * produces broken media — branch on this flag and render <video src={getDefaultSrc(item)}>.
+     * Videos have no resized variant and no poster URL: the size argument is ignored, and
+     * createMediaSrcset does not apply.
+     */
     isVideo?: boolean | null;
     altText?: string | null;
     fileName?: string | null;

package/dist/storefront-models/src/models/order/gift-card-line/index.d.ts

@@ -0,0 +1,15 @@
+import { IkasTransactionType } from "../transaction";
+export type IkasOrderGiftCardLine = {
+    id: string;
+    amount: number;
+    code: string;
+    giftCardId: string;
+    type: IkasGiftCardType | null;
+    appliedTransactions: IkasOrderGiftCardLineAppliedTransaction[];
+};
+export type IkasOrderGiftCardLineAppliedTransaction = {
+    id: string;
+    amount: number;
+    type: IkasTransactionType;
+};
+export type IkasGiftCardType = "GIFT_CARD" | "STORE_CREDIT";

package/dist/storefront-models/src/models/order/index.d.ts

@@ -1,6 +1,7 @@
 import { IkasOrderAddress } from "./address";
 import { IkasOrderAdjustment } from "./adjustment";
 import { IkasOrderCustomer } from "./customer";
+import { IkasOrderGiftCardLine } from "./gift-card-line";
 import { IkasOrderGiftPackageLine } from "./gift-line";
 import { IkasInvoice } from "./invoice";
 import { IkasOrderLineItem } from "./line-item";
@@ -21,6 +22,7 @@ export type IkasOrder = {
     currencySymbol: string | null;
     customer: IkasOrderCustomer | null;
     customerId: string | null;
+    giftCardLines: IkasOrderGiftCardLine[] | null;
     giftPackageLines: IkasOrderGiftPackageLine[] | null;
     giftPackageNote: string | null;
     invoices: IkasInvoice[] | null;

package/dist/storefront-models/src/models/order/line-item/index.d.ts

@@ -27,4 +27,4 @@ export type IkasOrderLineItem = {
     orderedAt: number;
     _refundQuantity: number | null;
 };
-export type IkasOrderLineItemStatus = "CANCELLED" | "CANCEL_REJECTED" | "CANCEL_REQUESTED" | "DELIVERED" | "FULFILLED" | "REFUNDED" | "REFUND_REJECTED" | "REFUND_REQUESTED" | "REFUND_REQUEST_ACCEPTED" | "UNFULFILLED";
+export type IkasOrderLineItemStatus = "CANCELLED" | "CANCEL_REJECTED" | "CANCEL_REQUESTED" | "DELIVERED" | "FULFILLED" | "PLANNED" | "REFUNDED" | "REFUND_REJECTED" | "REFUND_REQUESTED" | "REFUND_REQUEST_ACCEPTED" | "RETURN_DELIVERED" | "RETURN_IN_TRANSIT" | "RETURN_PARCEL_WAITING" | "RETURN_REJECTED" | "UNFULFILLED" | "WAITING_FOR_PACKAGING";

package/dist/storefront-models/src/models/order/package/index.d.ts

@@ -13,7 +13,7 @@ export type IkasOrderPackage = {
     stockLocationId: string;
     trackingInfo: IkasTrackingInfo | null;
 };
-export type IkasOrderPackageFullfillStatus = "UNFULFILLED" | "CANCELLED" | "CANCEL_REJECTED" | "CANCEL_REQUESTED" | "DELIVERED" | "ERROR" | "FULFILLED" | "READY_FOR_PICK_UP" | "READY_FOR_SHIPMENT" | "REFUNDED" | "REFUND_REJECTED" | "REFUND_REQUESTED" | "REFUND_REQUEST_ACCEPTED" | "UNABLE_TO_DELIVER";
+export type IkasOrderPackageFullfillStatus = "CANCELLED" | "CANCEL_REJECTED" | "CANCEL_REQUESTED" | "DELIVERED" | "ERROR" | "FULFILLED" | "PLANNED" | "READY_FOR_PICK_UP" | "READY_FOR_SHIPMENT" | "REFUNDED" | "REFUND_REJECTED" | "REFUND_REQUESTED" | "REFUND_REQUEST_ACCEPTED" | "RETURN_DELIVERED" | "RETURN_IN_TRANSIT" | "RETURN_PARCEL_WAITING" | "RETURN_REJECTED" | "UNABLE_TO_DELIVER" | "UNFULFILLED" | "WAITING_FOR_PACKAGING";
 export type IkasDisplayedPackage = {
     id: string;
     createdAt: number;

package/dist/storefront-models/src/models/payment-gateway/index.d.ts

@@ -22,7 +22,7 @@ export type IkasPaymentGateway = {
     settings?: IkasPaymentGatewaySettings[] | null;
     translations?: IkasPaymentGatewayTranslation[] | null;
 };
-export type IkasPaymentMethodType = "APP_PAYMENT" | "BANK_REDIRECT" | "BUY_ONLINE_PAY_AT_STORE" | "CASH" | "CASH_ON_DELIVERY" | "CREDIT_CARD" | "CREDIT_CARD_ON_DELIVERY" | "DIRECT_DEBIT" | "GIFT_CARD" | "MONEY_ORDER" | "OTHER" | "PAY_LATER" | "SLICE_IT" | "WALLET";
+export type IkasPaymentMethodType = "APP_PAYMENT" | "BANK_REDIRECT" | "BUY_ONLINE_PAY_AT_STORE" | "CASH" | "CASH_ON_DELIVERY" | "CREDIT_CARD" | "CREDIT_CARD_ON_DELIVERY" | "DIRECT_DEBIT" | "GIFT_CARD" | "MONEY_ORDER" | "OTHER" | "PAY_LATER" | "SLICE_IT" | "STORE_CREDIT" | "WALLET";
 export type IkasPaymentMethod = {
     name: string;
     logoUrl: string | null;

package/dist/storefront-models/src/models/product/image/index.d.ts

@@ -3,6 +3,11 @@ export type IkasProductImage = {
     fileName: string | null;
     imageId: string | null;
     isMain: boolean;
+    /**
+     * True when this media item is a VIDEO, not an image. Product galleries, cards, swatches and
+     * line items must branch on it: render <video src={getDefaultSrc(item.image)}> instead of an
+     * <img>, otherwise the .mp4 URL lands in an <img> and the media breaks.
+     */
     isVideo: boolean | null;
     order: number;
     image?: IkasImage | null;

package/dist/storefront-models/src/models/validator/deactivate-customer/index.d.ts

@@ -0,0 +1,4 @@
+import { IkasForm, IkasFormItem } from "..";
+export type DeactivateCustomerForm = {
+    password: IkasFormItem;
+} & IkasForm;

package/dist/stores/customer/index.d.ts

@@ -1,6 +1,6 @@
 import { ProductFacetCount, SearchProduct } from "../../storefront-api/src";
 import { APIResponse } from "../../storefront-api-client/src";
-import { AccountInfoForm, AddressForm, BackInStockNotificationForm, ContactForm, CouponCodeForm, CustomerReviewForm, ForgotPasswordForm, IkasCustomer, IkasFavoriteProduct, IkasLastViewedProduct, IkasOrderRefundSettings, IkasProduct, LoginForm, NewsletterSubscriptionForm, OrderTrackingForm, RecoverPasswordForm, RegisterForm, SmsLoginForm, VerifyPhoneNumberForm } from "../../storefront-models/src";
+import { AccountInfoForm, AddressForm, BackInStockNotificationForm, ContactForm, CouponCodeForm, CustomerReviewForm, DeactivateCustomerForm, ForgotPasswordForm, IkasCustomer, IkasFavoriteProduct, IkasLastViewedProduct, IkasOrderRefundSettings, IkasProduct, LoginForm, NewsletterSubscriptionForm, OrderTrackingForm, RecoverPasswordForm, RegisterForm, SmsLoginForm, VerifyPhoneNumberForm } from "../../storefront-models/src";
 export type IkasCustomerStore = {
     customer: IkasCustomer | null;
     _token: string | null;
@@ -19,6 +19,7 @@ export type IkasCustomerStore = {
     _contactForm: ContactForm | null;
     _couponCodeForm: CouponCodeForm | null;
     _customerReviewForms: Record<string, CustomerReviewForm>;
+    _deactivateCustomerForm: DeactivateCustomerForm | null;
     _forgotPasswordForm: ForgotPasswordForm | null;
     _loginForm: LoginForm | null;
     _smsLoginForm: SmsLoginForm | null;

package/dist/stores/customer/index.js

@@ -1 +1 @@
-import{observable as o}from'./../../ext/mobx/dist/mobx.esm.js';var r=o({customer:null,_token:null,_tokenExpiry:null,_initialized:!1,_visitorSubscribedEmail:!1,_lastViewedProducts:[],_customerConsentGranted:!1,_refundSettings:null,_captchaToken:null,_savedLastViewedProducts:[],_savedLastViewedProductsResponse:null,_accountInfoForm:null,_addressForms:{},_backInStockForms:{},_contactForm:null,_couponCodeForm:null,_customerReviewForms:{},_forgotPasswordForm:null,_loginForm:null,_smsLoginForm:null,_verifyPhoneNumberForm:null,_newsletterSubscriptionForm:null,_orderTrackingForm:null,_recoverPasswordForm:null,_registerForm:null,_favoriteProducts:[],_isFavoriteProductsLoaded:!1});export{r as customerStore};
+import{observable as o}from'./../../ext/mobx/dist/mobx.esm.js';var r=o({customer:null,_token:null,_tokenExpiry:null,_initialized:!1,_visitorSubscribedEmail:!1,_lastViewedProducts:[],_customerConsentGranted:!1,_refundSettings:null,_captchaToken:null,_savedLastViewedProducts:[],_savedLastViewedProductsResponse:null,_accountInfoForm:null,_addressForms:{},_backInStockForms:{},_contactForm:null,_couponCodeForm:null,_customerReviewForms:{},_deactivateCustomerForm:null,_forgotPasswordForm:null,_loginForm:null,_smsLoginForm:null,_verifyPhoneNumberForm:null,_newsletterSubscriptionForm:null,_orderTrackingForm:null,_recoverPasswordForm:null,_registerForm:null,_favoriteProducts:[],_isFavoriteProductsLoaded:!1});export{r as customerStore};

package/dist/utils/currency.d.ts

@@ -1,7 +1,40 @@
 /**
+ * Format a free-standing amount with the merchant's currency format settings. Use this for
+ * amounts that are NOT tied to a model (remaining amount to free shipping, gift wrap threshold,
+ * bulk discount limits, cart limit warnings). For model-bound prices, prefer the
+ * `get*FormattedPrice` helpers — they call this function internally.
  *
- * @param price Price to format
- * @param currencyCode Currency code
- * @param currencySymbol Symbol for the currency
+ * Applies the merchant's `currencyFormats` entry for the given currency code (symbol,
+ * symbolPosition, thousandSeparator, decimalSeparator, omitZeroDecimal). Behavior details:
+ * always two decimal places, and a space between the symbol and the number. `omitZeroDecimal`
+ * drops the fraction only when it is exactly `00`.
+ *
+ * Do NOT use `Intl.NumberFormat` for currency — it falls back to the browser locale and
+ * produces a format that conflicts with platform-formatted prices on the same screen.
+ *
+ * @ai-category Pricing
+ * @ai-related getProductVariantFormattedFinalPrice, getOrderLineItemFormattedFinalPrice, getIkasOrderFormattedTotalFinalPrice
+ *
+ * @param price - The amount to format
+ * @param currencyCode - Currency code used to look up the merchant format settings (e.g. "TRY", "USD")
+ * @param currencySymbol - Fallback symbol used when the merchant has no format entry for the code.
+ *   Always pass the symbol from the model you took the amount from (e.g. `cart.currencySymbol`) —
+ *   passing `null` can render the amount with no symbol at all.
+ * @returns The amount formatted with the merchant's currency format (e.g. "₺ 1,950.00")
+ *
+ * @example
+ * ```typescript
+ * import { cartStore, formatCurrency } from "@ikas/bp-storefront";
+ *
+ * function FreeShippingBar({ threshold }: { threshold: number }) {
+ *   const cart = cartStore.cart;
+ *   if (!cart) return null;
+ *
+ *   const remaining = threshold - cart.totalFinalPrice;
+ *   if (remaining <= 0) return <span>Free shipping unlocked!</span>;
+ *
+ *   return <span>Add {formatCurrency(remaining, cart.currencyCode, cart.currencySymbol)} more for free shipping</span>;
+ * }
+ * ```
  */
 export declare const formatCurrency: (price: number, currencyCode: string, currencySymbol: string | null) => string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ikas/bp-storefront",
-  "version": "2.8.0",
+  "version": "2.9.1",
   "description": "A framework for the ikas blueprint storefronts.",
   "author": "ikas",
   "license": "ISC",