@ikas/code-components-mcp 2.7.0 → 2.9.0

package/data/section-templates/product-detail-section/utils/cartLimits.ts

@@ -8,9 +8,10 @@ export interface CartQuantityLimits {
 /**
  * Resolve the per-cart quantity limits for a product from its active sales
  * channel. Falls back to a minimum of 1 and no maximum when the channel or its
- * limits are not set. `addItemToCart` clamps to the same limits internally, so
- * applying these in the stepper keeps the UI honest instead of letting the
- * quantity snap silently.
+ * limits are not set. `addItemToCart` clamps to the same limits internally only
+ * when it creates a NEW cart line — incrementing an existing line goes through
+ * `changeItemQuantity`, which never clamps — so enforcing these in the stepper
+ * is the only guard that covers both paths.
  */
 export function getProductCartLimits(product: IkasProduct): CartQuantityLimits {
   const channel = product.salesChannels?.find(

package/data/section-templates/product-pricing/ikas-config-snippet.json

@@ -16,6 +16,10 @@
       "displayName": "Top Spacing",
       "type": "TYPE",
       "required": false,
+      "defaultValue": {
+        "value": 0,
+        "unit": "px"
+      },
       "groupId": "mobile",
       "typeId": "@ikas/bp-storefront-models-MarginTopStyleType"
     },
@@ -24,6 +28,10 @@
       "displayName": "Bottom Spacing",
       "type": "TYPE",
       "required": false,
+      "defaultValue": {
+        "value": 0,
+        "unit": "px"
+      },
       "groupId": "mobile",
       "typeId": "@ikas/bp-storefront-models-MarginBottomStyleType"
     },
@@ -32,6 +40,10 @@
       "displayName": "Top Spacing",
       "type": "TYPE",
       "required": false,
+      "defaultValue": {
+        "value": 0,
+        "unit": "px"
+      },
       "groupId": "desktop",
       "typeId": "@ikas/bp-storefront-models-MarginTopStyleType"
     },
@@ -40,6 +52,10 @@
       "displayName": "Bottom Spacing",
       "type": "TYPE",
       "required": false,
+      "defaultValue": {
+        "value": 0,
+        "unit": "px"
+      },
       "groupId": "desktop",
       "typeId": "@ikas/bp-storefront-models-MarginBottomStyleType"
     }

package/data/section-templates/product-slider-section/children/CardProductName/ikas-config-snippet.json

@@ -15,7 +15,8 @@
       "name": "singleLineName",
       "displayName": "Single Row First Name",
       "type": "BOOLEAN",
-      "required": false
+      "required": false,
+      "defaultValue": false
     }
   ]
 }

package/data/section-templates/product-slider-section/ikas-config-snippet.json

@@ -57,6 +57,7 @@
       "displayName": "Column Count",
       "type": "ENUM",
       "required": false,
+      "defaultValue": "Four",
       "groupId": "appearance",
       "enumTypeId": "{{ENUM_ID:NumberOfColumns}}"
     },
@@ -65,6 +66,7 @@
       "displayName": "Aspect Ratio",
       "type": "ENUM",
       "required": false,
+      "defaultValue": "Square",
       "groupId": "appearance",
       "enumTypeId": "{{ENUM_ID:AspectRatio}}"
     },
@@ -73,6 +75,7 @@
       "displayName": "Image Fit",
       "type": "ENUM",
       "required": false,
+      "defaultValue": "Cover",
       "groupId": "appearance",
       "enumTypeId": "{{ENUM_ID:ObjectFit}}"
     },
@@ -81,6 +84,7 @@
       "displayName": "Hide Add to Cart Button",
       "type": "BOOLEAN",
       "required": false,
+      "defaultValue": false,
       "groupId": "appearance"
     },
     {
@@ -88,6 +92,19 @@
       "displayName": "Components",
       "type": "COMPONENT_LIST",
       "required": false,
+      "defaultValue": {
+        "components": [
+          {
+            "codeComponentId": "nb34u3yu-card-product-name"
+          },
+          {
+            "codeComponentId": "nb34u3yu-card-product-variants"
+          },
+          {
+            "codeComponentId": "nb34u3yu-card-product-price"
+          }
+        ]
+      },
       "privateVarMap": {
         "product": {
           "id": "pvm_1772803530689_1",

package/data/section-templates/register-section/ikas-config-snippet.json

@@ -142,6 +142,7 @@
       "displayName": "Google Login",
       "type": "BOOLEAN",
       "required": false,
+      "defaultValue": false,
       "groupId": "google"
     },
     {
@@ -157,6 +158,7 @@
       "displayName": "Facebook Login",
       "type": "BOOLEAN",
       "required": false,
+      "defaultValue": false,
       "groupId": "facebook"
     },
     {

package/data/section-templates/variant-selection/ikas-config-snippet.json

@@ -16,6 +16,10 @@
       "displayName": "Top Spacing",
       "type": "TYPE",
       "required": false,
+      "defaultValue": {
+        "value": 0,
+        "unit": "px"
+      },
       "groupId": "mobile",
       "typeId": "@ikas/bp-storefront-models-MarginTopStyleType"
     },
@@ -24,6 +28,10 @@
       "displayName": "Bottom Spacing",
       "type": "TYPE",
       "required": false,
+      "defaultValue": {
+        "value": 0,
+        "unit": "px"
+      },
       "groupId": "mobile",
       "typeId": "@ikas/bp-storefront-models-MarginBottomStyleType"
     },
@@ -32,6 +40,10 @@
       "displayName": "Top Spacing",
       "type": "TYPE",
       "required": false,
+      "defaultValue": {
+        "value": 0,
+        "unit": "px"
+      },
       "groupId": "desktop",
       "typeId": "@ikas/bp-storefront-models-MarginTopStyleType"
     },
@@ -40,6 +52,10 @@
       "displayName": "Bottom Spacing",
       "type": "TYPE",
       "required": false,
+      "defaultValue": {
+        "value": 0,
+        "unit": "px"
+      },
       "groupId": "desktop",
       "typeId": "@ikas/bp-storefront-models-MarginBottomStyleType"
     },
@@ -48,6 +64,7 @@
       "displayName": "Image Variant",
       "type": "BOOLEAN",
       "required": false,
+      "defaultValue": false,
       "description": "Use product images for color variant."
     }
   ],

package/data/storefront-api.json

@@ -1,5 +1,5 @@
 {
-  "generatedAt": "2026-07-27T13:33:15.430Z",
+  "generatedAt": "2026-09-03T13:13:43.900Z",
   "functions": [
     {
       "name": "apiListProductBrand",
@@ -2788,16 +2788,16 @@
     {
       "name": "getThumbnailSrc",
       "signature": "function getThumbnailSrc(image: IkasImage): string",
-      "description": "Returns the thumbnail source URL for an image OR video at 180px resolution.\n\nWhen mapping over product media (IkasProductImage[]), some items are videos:\ncheck `item.isVideo` and render a `<video>` thumbnail (typically with a play\noverlay) instead of an `<img>` when it is true.",
+      "description": "Returns the thumbnail source URL for an IMAGE at 180px resolution.\n\nVIDEOS HAVE NO 180px THUMBNAIL and no poster URL. When `image.isVideo === true` the size is\nIGNORED and this returns the same full-size .mp4 as `getDefaultSrc(image)` — so using it in a\nthumbnail-sized box (swatch, cart line, order line) downloads the whole video instead of a\n180px webp. Nothing looks broken, which makes it a silent performance regression.\n\nBranch on `item.isVideo` first and only pass images here. For the video branch in a small,\nstatic context render `<video src={getDefaultSrc(item)} preload=\"metadata\" muted playsInline>`\nwith no `autoPlay`: the browser fetches only the first frame and holds it as a stand-in poster.",
       "params": [
         {
           "name": "image",
-          "description": "- The image object to generate the thumbnail source URL for."
+          "description": "- The image object to generate the thumbnail source URL for. Videos ignore the size."
         }
       ],
-      "returns": "The CDN URL string for the image or video at 180px size.",
+      "returns": "The CDN URL string: a 180px image, or — for `isVideo` items — the original .mp4.",
       "returnType": "string",
-      "example": "```typescript\nimport { getThumbnailSrc, getDefaultSrc } from \"@ikas/bp-storefront\";\n\n// Thumbnail rail — branch on isVideo per item:\n{product.images.map((item, i) =>\n  item.isVideo ? (\n    <video key={i} src={getDefaultSrc(item)} muted preload=\"metadata\">\n      <track kind=\"captions\" />\n    </video>\n  ) : (\n    <img key={i} src={getThumbnailSrc(item)} sizes=\"112px\" alt={`Thumb ${i + 1}`} />\n  )\n)}\n```",
+      "example": "```typescript\nimport { getThumbnailSrc, getDefaultSrc } from \"@ikas/bp-storefront\";\n\n// Thumbnail rail — branch on isVideo per item (no autoPlay: first frame acts as the poster):\n{product.images.map((item, i) =>\n  item.isVideo ? (\n    <video key={i} src={getDefaultSrc(item)} muted playsInline preload=\"metadata\">\n      <track kind=\"captions\" />\n    </video>\n  ) : (\n    <img key={i} src={getThumbnailSrc(item)} sizes=\"112px\" alt={`Thumb ${i + 1}`} />\n  )\n)}\n```",
       "categories": [
         "Image"
       ],
@@ -3085,6 +3085,35 @@
         "IkasOrderGiftPackageLine"
       ]
     },
+    {
+      "name": "getIkasOrderGiftCardTotalPrice",
+      "displayName": "getGiftCardTotalPrice",
+      "signature": "function getIkasOrderGiftCardTotalPrice(order: IkasOrder): number",
+      "description": "Returns the total amount covered by the gift cards (and store credits) applied to the order or cart.\n\nThis is a derived value, the API does not return it: it sums `amount` over `order.giftCardLines`.\nSubtract it from `order.totalFinalPrice` to get the amount still due.",
+      "params": [
+        {
+          "name": "order",
+          "description": "- The IkasOrder or IkasCart holding the gift card lines"
+        }
+      ],
+      "returns": "The summed gift card amount, or 0 when no gift card is applied",
+      "returnType": "number",
+      "example": "```typescript\nimport { getIkasOrderGiftCardTotalPrice } from \"@ikas/bp-storefront\";\n\nconst giftCardTotal = getIkasOrderGiftCardTotalPrice(cart);\nconst remainingPrice = cart.totalFinalPrice - giftCardTotal;\n```",
+      "categories": [
+        "Order",
+        "Cart"
+      ],
+      "related": [
+        "removeGiftCardLine",
+        "saveCouponCode"
+      ],
+      "isAsync": false,
+      "isClass": false,
+      "parameterTypes": [
+        "IkasOrderGiftCardTotalPrice",
+        "IkasOrder"
+      ]
+    },
     {
       "name": "getIkasOrderDistinctItemCount",
       "displayName": "getDistinctItemCount",
@@ -10746,6 +10775,88 @@
       "isAsync": true,
       "isClass": false
     },
+    {
+      "name": "initDeactivateCustomerForm",
+      "displayName": "init",
+      "signature": "function initDeactivateCustomerForm(deactivateCustomerForm: DeactivateCustomerForm): void",
+      "description": "Initializes the deactivate customer form with default password field values, labels, and placeholders.",
+      "params": [
+        {
+          "name": "deactivateCustomerForm",
+          "description": "- The deactivate customer form model to initialize"
+        }
+      ],
+      "returns": "void",
+      "returnType": "void",
+      "example": "```typescript\nimport { initDeactivateCustomerForm } from \"@ikas/bp-storefront\";\ninitDeactivateCustomerForm(deactivateCustomerForm);\n```",
+      "categories": [
+        "Validation",
+        "DeactivateCustomer",
+        "Form"
+      ],
+      "related": [
+        "setDeactivateCustomerFormPassword",
+        "submitDeactivateCustomerForm"
+      ],
+      "isAsync": false,
+      "isClass": false
+    },
+    {
+      "name": "setDeactivateCustomerFormPassword",
+      "displayName": "setPassword",
+      "signature": "function setDeactivateCustomerFormPassword(deactivateCustomerForm: DeactivateCustomerForm, value: string): void",
+      "description": "Sets the password value on the deactivate customer form and re-validates if the form has already been submitted.",
+      "params": [
+        {
+          "name": "deactivateCustomerForm",
+          "description": "- The deactivate customer form model to update"
+        },
+        {
+          "name": "value",
+          "description": "- The new password string to set"
+        }
+      ],
+      "returns": "void",
+      "returnType": "void",
+      "example": "```typescript\nimport { setDeactivateCustomerFormPassword } from \"@ikas/bp-storefront\";\nsetDeactivateCustomerFormPassword(deactivateCustomerForm, \"mySecurePassword123\");\n```",
+      "categories": [
+        "Validation",
+        "DeactivateCustomer",
+        "Form"
+      ],
+      "related": [
+        "initDeactivateCustomerForm",
+        "submitDeactivateCustomerForm"
+      ],
+      "isAsync": false,
+      "isClass": false
+    },
+    {
+      "name": "submitDeactivateCustomerForm",
+      "displayName": "submit",
+      "signature": "async function submitDeactivateCustomerForm(deactivateCustomerForm: DeactivateCustomerForm): Promise<boolean>",
+      "description": "Validates and submits the deactivate customer form, deleting the current customer's account after password verification.\nThe customer session is not cleared automatically, call `logout` after a successful submission.",
+      "params": [
+        {
+          "name": "deactivateCustomerForm",
+          "description": "- The deactivate customer form model to submit"
+        }
+      ],
+      "returns": "A promise that resolves to true if the account was deactivated successfully, or false on validation error or API failure",
+      "returnType": "Promise<boolean>",
+      "example": "```typescript\nimport { customerStore, logout, submitDeactivateCustomerForm } from \"@ikas/bp-storefront\";\nconst success = await submitDeactivateCustomerForm(deactivateCustomerForm);\nif (success) {\n  await logout(customerStore);\n}\n```",
+      "categories": [
+        "Validation",
+        "DeactivateCustomer",
+        "Form"
+      ],
+      "related": [
+        "initDeactivateCustomerForm",
+        "setDeactivateCustomerFormPassword"
+      ],
+      "isAsync": true,
+      "isClass": false
+    },
     {
       "name": "initForgotPasswordForm",
       "displayName": "init",
@@ -12589,11 +12700,27 @@
       "name": "bs_searchProductById",
       "displayName": "searchProductById",
       "signature": "async function bs_searchProductById(baseStore: BaseStore, params: { productId: string }): Promise<{\n  isSuccess: boolean;\n  product: IkasProduct | null;\n}>",
-      "description": "",
-      "params": [],
+      "description": "Fetches a single product by id and returns it as a full `IkasProduct`.\n\nUse this when a lightweight reference (e.g. a cart line's `IkasOrderLineVariant`, which carries\nneither `salesChannels` nor `stock`) needs product-level data: the returned product includes\n`salesChannels` filtered to the active sales channel (with `minQuantityPerCart` /\n`maxQuantityPerCart`) and per-variant `stock` (summed over the sales channel's configured\nstock locations). `selectedVariantValues` is seeded from the first active variant (or the\nfirst variant when none is active). For multiple ids, prefer `bs_searchProductsById` — one\nbatched request.",
+      "params": [
+        {
+          "name": "baseStore",
+          "description": "- The base store instance"
+        },
+        {
+          "name": "params",
+          "description": "- `{ productId }` — id of the product to fetch"
+        }
+      ],
+      "returns": "`{ isSuccess, product }` — `product` is null when not found or on failure",
       "returnType": "Promise<{\n  isSuccess: boolean;\n  product: IkasProduct | null;\n}>",
-      "categories": [],
-      "related": [],
+      "example": "```tsx\nimport { baseStore, bs_searchProductById, IkasStorefrontConfig } from \"@ikas/bp-storefront\";\n\nconst { isSuccess, product } = await bs_searchProductById(baseStore, { productId });\nif (isSuccess && product) {\n  const channel = product.salesChannels?.find(sc => sc.id === IkasStorefrontConfig.salesChannelId);\n  console.log(channel?.maxQuantityPerCart);\n}\n```",
+      "categories": [
+        "Product",
+        "Search"
+      ],
+      "related": [
+        "bs_searchProductsById"
+      ],
       "isAsync": true,
       "isClass": false,
       "parameterTypes": [
@@ -12604,11 +12731,29 @@
       "name": "bs_searchProductsById",
       "displayName": "searchProductsById",
       "signature": "async function bs_searchProductsById(baseStore: BaseStore, params: { productIds: string[] }): Promise<{\n  isSuccess: boolean;\n  products: IkasProduct[] | null;\n}>",
-      "description": "",
-      "params": [],
+      "description": "Batch-fetches products by id in a single request and returns them as full `IkasProduct` objects.\n\nThe go-to function when cart lines (or any lightweight reference) need product-level data they\ndo not carry: `IkasOrderLineVariant` has neither `salesChannels` nor `stock`, while the products\nreturned here include `salesChannels` filtered to the active sales channel (with\n`minQuantityPerCart` / `maxQuantityPerCart`) and per-variant `stock` (summed over the sales\nchannel's configured stock locations). Collect the distinct `productId`s of the lines and\nfetch them in ONE call instead of one request per line. Called with an empty `productIds`,\nit returns `{ isSuccess: true, products: [] }` without a network request.",
+      "params": [
+        {
+          "name": "baseStore",
+          "description": "- The base store instance"
+        },
+        {
+          "name": "params",
+          "description": "- `{ productIds }` — product ids to fetch (deduplicate before calling)"
+        }
+      ],
+      "returns": "`{ isSuccess, products }` — `products` is null on failure",
       "returnType": "Promise<{\n  isSuccess: boolean;\n  products: IkasProduct[] | null;\n}>",
-      "categories": [],
-      "related": [],
+      "example": "```tsx\nimport { baseStore, bs_searchProductsById, cartStore, IkasStorefrontConfig } from \"@ikas/bp-storefront\";\n\n// Enforce per-cart quantity limits on cart lines:\nconst productIds = [\n  ...new Set(\n    (cartStore.cart?.orderLineItems ?? [])\n      .map(item => item.variant.productId)\n      .filter((id): id is string => !!id)\n  ),\n];\nconst { products } = await bs_searchProductsById(baseStore, { productIds });\nconst maxByProductId = new Map<string, number | null>();\nfor (const p of products ?? []) {\n  const channel = p.salesChannels?.find(sc => sc.id === IkasStorefrontConfig.salesChannelId);\n  maxByProductId.set(p.id, channel?.maxQuantityPerCart ?? null);\n}\n```",
+      "categories": [
+        "Product",
+        "Cart",
+        "Search"
+      ],
+      "related": [
+        "bs_searchProductById",
+        "changeItemQuantity"
+      ],
       "isAsync": true,
       "isClass": false,
       "parameterTypes": [
@@ -12646,7 +12791,7 @@
       "name": "addItemToCart",
       "displayName": "addVariantToCart",
       "signature": "async function addItemToCart(variant: IkasProductVariant, product: IkasProduct, initialQuantity: number = 1, options?: AddItemOptions): Promise<IkasCartOperationResult>",
-      "description": "Add a product variant to the shopping cart.",
+      "description": "Add a product variant to the shopping cart.\n\nClamps the quantity to the sales channel's `minQuantityPerCart`/`maxQuantityPerCart` only\nwhen it creates a new cart line. When the variant already has a line in the cart, the add\nis delegated to `changeItemQuantity` (existing quantity + `initialQuantity`) with no\nclient-side clamp — a quantity past `maxQuantityPerCart` is then rejected by the API with\nthe `MAX_QUANTITY_PER_CART_LIMIT_REACHED` code in `result.response.errorCodes`, never as a\n`validationError`. See `changeItemQuantity` for the handling pattern.",
       "params": [
         {
           "name": "variant",
@@ -12722,7 +12867,7 @@
       "name": "changeItemQuantity",
       "displayName": "changeQuantityOnCart",
       "signature": "async function changeItemQuantity(item: IkasOrderLineItem, quantity: number, offers?: IkasProductOffer[], product?: IkasProduct): Promise<IkasCartOperationResult>",
-      "description": "Change the quantity of an item in the cart.\nUse quantity=0 to remove the item.",
+      "description": "Change the quantity of an item in the cart.\nUse quantity=0 to remove the item.\n\nPerforms no client-side clamping or validation: a quantity above the sales channel's\n`maxQuantityPerCart` is rejected by the API with the `MAX_QUANTITY_PER_CART_LIMIT_REACHED`\ncode in `result.response.errorCodes` (never as a `validationError`). Prevent violations in\nthe stepper and treat the error code as the fallback.",
       "params": [
         {
           "name": "item",
@@ -12743,7 +12888,7 @@
       ],
       "returns": "Result with success flag",
       "returnType": "Promise<IkasCartOperationResult>",
-      "example": "```typescript\nimport { cartStore, changeItemQuantity } from \"@ikas/bp-storefront\";\n\n// Increment quantity\nasync function handleIncrement(itemId: string) {\n  const item = cartStore.cart?.orderLineItems.find(i => i.id === itemId);\n  if (item) {\n    const result = await changeItemQuantity(item, item.quantity + 1);\n    if (!result.success) {\n      showToast(\"Failed to update quantity\");\n    }\n  }\n}\n\n// Decrement quantity\nasync function handleDecrement(itemId: string) {\n  const item = cartStore.cart?.orderLineItems.find(i => i.id === itemId);\n  if (item && item.quantity > 1) {\n    await changeItemQuantity(item, item.quantity - 1);\n  }\n}\n```",
+      "example": "```typescript\nimport { APIErrorCode, cartStore, changeItemQuantity } from \"@ikas/bp-storefront\";\n\n// Increment quantity\nasync function handleIncrement(itemId: string) {\n  const item = cartStore.cart?.orderLineItems.find(i => i.id === itemId);\n  if (item) {\n    const result = await changeItemQuantity(item, item.quantity + 1);\n    if (!result.success) {\n      const limitHit = result.response?.errorCodes?.includes(\n        APIErrorCode.MAX_QUANTITY_PER_CART_LIMIT_REACHED\n      );\n      showToast(limitHit ? \"Per-cart quantity limit reached\" : \"Failed to update quantity\");\n    }\n  }\n}\n\n// Decrement quantity\nasync function handleDecrement(itemId: string) {\n  const item = cartStore.cart?.orderLineItems.find(i => i.id === itemId);\n  if (item && item.quantity > 1) {\n    await changeItemQuantity(item, item.quantity - 1);\n  }\n}\n```",
       "categories": [
         "Cart"
       ],
@@ -13052,6 +13197,37 @@
         "IkasCartOperationResult"
       ]
     },
+    {
+      "name": "removeGiftCardLine",
+      "signature": "async function removeGiftCardLine(cart: IkasCart, giftCardId?: string | null): Promise<IkasCartOperationResult>",
+      "description": "Remove a gift card (or store credit) line from the cart.\n\nGift cards are applied through `saveCouponCode` with the gift card code, and the applied\ncards are listed on `cart.giftCardLines`. Pass the `giftCardId` of the line to remove; when\nomitted, every gift card line is removed from the cart.",
+      "params": [
+        {
+          "name": "cart",
+          "description": "- The cart object"
+        },
+        {
+          "name": "giftCardId",
+          "description": "- The gift card to remove, or null/undefined to remove all of them"
+        }
+      ],
+      "returns": "Result with success flag",
+      "returnType": "Promise<IkasCartOperationResult>",
+      "example": "```typescript\nimport { cartStore, removeGiftCardLine } from \"@ikas/bp-storefront\";\n\nasync function handleRemoveGiftCard(giftCardId: string) {\n  if (!cartStore.cart) return;\n\n  const result = await removeGiftCardLine(cartStore.cart, giftCardId);\n  if (result.success) {\n    showToast(\"Gift card removed\");\n  }\n}\n```",
+      "categories": [
+        "Cart"
+      ],
+      "related": [
+        "saveCouponCode",
+        "getIkasOrderGiftCardTotalPrice"
+      ],
+      "isAsync": true,
+      "isClass": false,
+      "parameterTypes": [
+        "IkasCart",
+        "IkasCartOperationResult"
+      ]
+    },
     {
       "name": "getCart",
       "signature": "async function getCart(): Promise<void>",
@@ -13952,7 +14128,8 @@
       ],
       "related": [
         "hasCustomer",
-        "logout"
+        "logout",
+        "getDeactivateCustomerForm"
       ],
       "isAsync": true,
       "isClass": false,
@@ -14523,6 +14700,58 @@
         "IkasCustomerStore"
       ]
     },
+    {
+      "name": "getDeactivateCustomerForm",
+      "signature": "function getDeactivateCustomerForm(customerStore: IkasCustomerStore): DeactivateCustomerForm",
+      "description": "Get or initialize the deactivate customer form with validation for deleting the current customer's account.",
+      "params": [
+        {
+          "name": "customerStore",
+          "description": "- The customer store instance"
+        }
+      ],
+      "returns": "The deactivate customer form object with validated fields",
+      "returnType": "DeactivateCustomerForm",
+      "example": "```typescript\nimport {\n  customerStore,\n  getDeactivateCustomerForm,\n  setDeactivateCustomerFormPassword,\n  submitDeactivateCustomerForm,\n  logout,\n} from \"@ikas/bp-storefront\";\n\nfunction DeleteAccountPage() {\n  const form = getDeactivateCustomerForm(customerStore);\n\n  const handleSubmit = async () => {\n    const isSuccess = await submitDeactivateCustomerForm(form);\n    if (isSuccess) {\n      await logout(customerStore);\n      Router.navigateToPage(\"INDEX\");\n    }\n  };\n\n  return (\n    <form>\n      <input\n        type=\"password\"\n        value={form.password.value}\n        onChange={e => setDeactivateCustomerFormPassword(form, e.target.value)}\n      />\n      <button onClick={handleSubmit}>Delete Account</button>\n    </form>\n  );\n}\n```",
+      "categories": [
+        "Customer",
+        "Account"
+      ],
+      "related": [
+        "clearDeactivateCustomerForm",
+        "deactivateCustomer"
+      ],
+      "isAsync": false,
+      "isClass": false,
+      "parameterTypes": [
+        "IkasCustomerStore"
+      ]
+    },
+    {
+      "name": "clearDeactivateCustomerForm",
+      "signature": "function clearDeactivateCustomerForm(customerStore: IkasCustomerStore): void",
+      "description": "Clear the cached deactivate customer form, forcing a fresh form on next retrieval.",
+      "params": [
+        {
+          "name": "customerStore",
+          "description": "- The customer store instance"
+        }
+      ],
+      "returnType": "void",
+      "example": "```typescript\nimport { customerStore, clearDeactivateCustomerForm } from \"@ikas/bp-storefront\";\n\nfunction handleDeactivateCustomerReset() {\n  clearDeactivateCustomerForm(customerStore);\n}\n```",
+      "categories": [
+        "Customer",
+        "Account"
+      ],
+      "related": [
+        "getDeactivateCustomerForm"
+      ],
+      "isAsync": false,
+      "isClass": false,
+      "parameterTypes": [
+        "IkasCustomerStore"
+      ]
+    },
     {
       "name": "getForgotPasswordForm",
       "signature": "function getForgotPasswordForm(customerStore: IkasCustomerStore): ForgotPasswordForm",
@@ -15148,6 +15377,29 @@
       "isClass": true,
       "className": "Router"
     },
+    {
+      "name": "withRoutePrefix",
+      "signature": "function withRoutePrefix(path: string): string",
+      "description": "Put the visitor's storefront routing in front of a path you wrote yourself.\n\nEntity links (`getProductHref`, `getIkasOrderHref`, …) and LINK props already carry the prefix.\nA literal path in your own markup does not: `href=\"/cart\"` sends a visitor browsing `/en` to the\ndefault language. Wrap it, and a store with no extra routings gets the path back unchanged.\n\nIdempotent — a path that already starts with a supported routing segment is returned as-is.\nAnything that is not a path on this storefront — an absolute URL, `mailto:`, `tel:` — is returned\nuntouched, so a merchant-authored prop can be wrapped without checking it first.",
+      "params": [
+        {
+          "name": "path",
+          "description": "- A path on this storefront, starting with `/`"
+        }
+      ],
+      "returns": "The path under the current routing (e.g. `/cart` → `/en/cart`)",
+      "returnType": "string",
+      "example": "```tsx\nimport { Router, withRoutePrefix } from \"@ikas/bp-storefront\";\n\n// Correct href for crawlers, middle-click and open-in-new-tab...\n<a href={withRoutePrefix(\"/cart\")} onClick={e => {\n  e.preventDefault();\n  Router.navigateToPage(\"CART\"); // ...and this prefixes on its own.\n}}>Cart</a>\n```",
+      "categories": [
+        "Navigation"
+      ],
+      "related": [
+        "navigate",
+        "navigateToPage"
+      ],
+      "isAsync": false,
+      "isClass": false
+    },
     {
       "name": "registerThemeSettingValues",
       "signature": "function registerThemeSettingValues(values: Record<string, any> | null): void",
@@ -15273,6 +15525,38 @@
         "IkasComponentRendererProps"
       ]
     },
+    {
+      "name": "formatCurrency",
+      "signature": "function formatCurrency(price: number, currencyCode: string, currencySymbol: string | null): string",
+      "description": "Format a free-standing amount with the merchant's currency format settings. Use this for\namounts that are NOT tied to a model (remaining amount to free shipping, gift wrap threshold,\nbulk discount limits, cart limit warnings). For model-bound prices, prefer the\n`get*FormattedPrice` helpers — they call this function internally.\n\nApplies the merchant's `currencyFormats` entry for the given currency code (symbol,\nsymbolPosition, thousandSeparator, decimalSeparator, omitZeroDecimal). Behavior details:\nalways two decimal places, and a space between the symbol and the number. `omitZeroDecimal`\ndrops the fraction only when it is exactly `00`.\n\nDo NOT use `Intl.NumberFormat` for currency — it falls back to the browser locale and\nproduces a format that conflicts with platform-formatted prices on the same screen.",
+      "params": [
+        {
+          "name": "price",
+          "description": "- The amount to format"
+        },
+        {
+          "name": "currencyCode",
+          "description": "- Currency code used to look up the merchant format settings (e.g. \"TRY\", \"USD\")"
+        },
+        {
+          "name": "currencySymbol",
+          "description": "- Fallback symbol used when the merchant has no format entry for the code.\nAlways pass the symbol from the model you took the amount from (e.g. `cart.currencySymbol`) —\npassing `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\")",
+      "returnType": "string",
+      "example": "```typescript\nimport { cartStore, formatCurrency } from \"@ikas/bp-storefront\";\n\nfunction FreeShippingBar({ threshold }: { threshold: number }) {\n  const cart = cartStore.cart;\n  if (!cart) return null;\n\n  const remaining = threshold - cart.totalFinalPrice;\n  if (remaining <= 0) return <span>Free shipping unlocked!</span>;\n\n  return <span>Add {formatCurrency(remaining, cart.currencyCode, cart.currencySymbol)} more for free shipping</span>;\n}\n```",
+      "categories": [
+        "Pricing"
+      ],
+      "related": [
+        "getProductVariantFormattedFinalPrice",
+        "getOrderLineItemFormattedFinalPrice",
+        "getIkasOrderFormattedTotalFinalPrice"
+      ],
+      "isAsync": false,
+      "isClass": false
+    },
     {
       "name": "httpRequest",
       "signature": "async function httpRequest(url: string, method: HttpMethod, body?: Record<string, any>, headers?: Record<string, string>): Promise<FetchResponse>",