@ikas/code-components-mcp 1.4.0-beta.23 → 1.4.0-beta.231

package/data/storefront-api.json

@@ -1,5 +1,5 @@
 {
-  "generatedAt": "2026-06-04T10:14:50.852Z",
+  "generatedAt": "2026-10-22T10:54:07.787Z",
   "functions": [
     {
       "name": "apiListProductBrand",
@@ -43,6 +43,20 @@
         "IkasStorefrontWidgetSettings"
       ]
     },
+    {
+      "name": "apiGetLoyaltyProgram",
+      "signature": "async function apiGetLoyaltyProgram(): Promise<APIResponse<IkasLoyaltyProgram>>",
+      "description": "",
+      "params": [],
+      "returnType": "Promise<APIResponse<IkasLoyaltyProgram>>",
+      "categories": [],
+      "related": [],
+      "isAsync": true,
+      "isClass": false,
+      "parameterTypes": [
+        "IkasLoyaltyProgram"
+      ]
+    },
     {
       "name": "apiListEarningMethods",
       "signature": "async function apiListEarningMethods(): Promise<APIResponse<IkasLoyaltyProgramEarningMethod[]>>",
@@ -167,7 +181,7 @@
       "name": "getAttributeDetailValues",
       "displayName": "getValues",
       "signature": "function getAttributeDetailValues(attributeDetail: IkasProductAttributeDetail): IkasProductAttributeValue[]",
-      "description": "Retrieves the attribute values for a product attribute detail, merging variant and product-level attributes.",
+      "description": "Retrieves the attribute values for a product attribute detail, merging variant and product-level attributes.\nThis is how a PRODUCT_ATTRIBUTE code-component prop is consumed: that prop hands you the\nIkasProductAttributeDetail wrapper ({ product, attributePropValue }), never the attribute value itself, so\nreading `prop.value` silently yields nothing — call this function instead.",
       "params": [
         {
           "name": "attributeDetail",
@@ -195,7 +209,7 @@
       "name": "getAttributeListValues",
       "displayName": "getValues",
       "signature": "function getAttributeListValues(list: IkasProductAttributeList): IkasProductAttributeMap[]",
-      "description": "Retrieves grouped attribute values for a product attribute list, combining variant and product-level attributes.",
+      "description": "Retrieves grouped attribute values for a product attribute list, combining variant and product-level attributes.\nThis is how a PRODUCT_ATTRIBUTE_LIST code-component prop is consumed: that prop hands you a single\nIkasProductAttributeList wrapper ({ product, attributeListPropValue }) — never an array — so mapping over the\nprop is a runtime error; call this function and iterate the returned { attribute, values } maps instead.",
       "params": [
         {
           "name": "list",
@@ -2761,16 +2775,16 @@
     {
       "name": "getDefaultSrc",
       "signature": "function getDefaultSrc(image: IkasImage): string",
-      "description": "Returns the default source URL for an image at 1080px resolution.",
+      "description": "Returns the default source URL for an image OR video at 1080px resolution.\n\nProduct media items (IkasProductImage) can be videos. ALWAYS check `item.isVideo`\nand render a `<video src={getDefaultSrc(item)}>` instead of an `<img>` when it is true.\nNever assume every media item is an image.",
       "params": [
         {
           "name": "image",
           "description": "- The image object to generate the default source URL for."
         }
       ],
-      "returns": "The CDN URL string for the image at 1080px size.",
+      "returns": "The CDN URL string for the image or video at 1080px size.",
       "returnType": "string",
-      "example": "```typescript\nimport { getDefaultSrc } from \"@ikas/bp-storefront\";\n\nconst src = getDefaultSrc(image);\nconsole.log(src); // \"https://cdn.example.com/images/.../1080/image.webp\"\n```",
+      "example": "```typescript\nimport { getDefaultSrc, createMediaSrcset } from \"@ikas/bp-storefront\";\n\n// Product images can be videos — ALWAYS branch on isVideo when mapping media:\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={getDefaultSrc(item)} srcSet={createMediaSrcset(item)} alt={`Product ${i + 1}`} />\n  )\n)}\n```",
       "categories": [
         "Image"
       ],
@@ -2788,16 +2802,16 @@
     {
       "name": "getThumbnailSrc",
       "signature": "function getThumbnailSrc(image: IkasImage): string",
-      "description": "Returns the thumbnail source URL for an image at 180px resolution.",
+      "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 at 180px size.",
+      "returns": "The CDN URL string: a 180px image, or — for `isVideo` items — the original .mp4.",
       "returnType": "string",
-      "example": "```typescript\nimport { getThumbnailSrc } from \"@ikas/bp-storefront\";\n\nconst thumbnailSrc = getThumbnailSrc(image);\nconsole.log(thumbnailSrc); // \"https://cdn.example.com/images/.../180/image.webp\"\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"
       ],
@@ -2815,7 +2829,7 @@
     {
       "name": "getSrc",
       "signature": "function getSrc(image: IkasImage, size: number): string",
-      "description": "Generates the full CDN source URL for an image or video at the specified size, handling both legacy path-based and merchant-scoped ID formats.",
+      "description": "Generates the full CDN source URL for an image or video at the specified size, handling both legacy path-based and merchant-scoped ID formats.\n\nNOTE: For videos (`image.isVideo === true`) the `size` argument is IGNORED — the original .mp4 is always returned.\nSo `getSrc(item, 240)` and `getDefaultSrc(item)` produce the identical URL for a video. PREFER `getDefaultSrc(item)`\nfor video `src` (no size param) — do NOT pass an arbitrary size like `getSrc(item, 240)`, it is misleading.",
       "params": [
         {
           "name": "image",
@@ -2823,12 +2837,12 @@
         },
         {
           "name": "size",
-          "description": "- The desired image width in pixels for the generated URL."
+          "description": "- The desired image width in pixels. Ignored for videos."
         }
       ],
       "returns": "The full CDN URL string for the image or video.",
       "returnType": "string",
-      "example": "```typescript\nimport { getSrc } from \"@ikas/bp-storefront\";\n\nconst src = getSrc(image, 640);\nconsole.log(src); // \"https://cdn.example.com/images/.../640/image.webp\"\n```",
+      "example": "```typescript\nimport { getSrc, getDefaultSrc } from \"@ikas/bp-storefront\";\n\nconst src = getSrc(image, 640);\nconsole.log(src); // \"https://cdn.example.com/images/.../640/image.webp\"\n\n// For a video, use getDefaultSrc (size is ignored anyway):\n<video src={getDefaultSrc(item)} muted playsInline preload=\"metadata\" />\n```",
       "categories": [
         "Image"
       ],
@@ -2846,7 +2860,7 @@
     {
       "name": "createMediaSrcset",
       "signature": "function createMediaSrcset(image?: IkasImage | null): string",
-      "description": "Generates a complete responsive `srcset` string for an image across all standard sizes (180–3840px).",
+      "description": "Generates a complete responsive `srcset` string for an image across all standard sizes (180–3840px).\n\nsrcset applies to `<img>` only — video media (`item.isVideo === true`) has no srcset\nand must be rendered with `<video src={getDefaultSrc(item)}>`. When mapping product\nimages, branch on `item.isVideo` first, then only use createMediaSrcset on the image branch.",
       "params": [
         {
           "name": "image",
@@ -2855,7 +2869,7 @@
       ],
       "returns": "A srcset string like `\"url 180w, url 360w, ...\"`, or an empty string if no image is provided.",
       "returnType": "string",
-      "example": "```typescript\nimport { createMediaSrcset, getDefaultSrc } from \"@ikas/bp-storefront\";\n\n<img\n  src={getDefaultSrc(image)}\n  srcSet={createMediaSrcset(image)}\n  sizes=\"(max-width: 768px) 100vw, 50vw\"\n  alt=\"Product\"\n/>\n```",
+      "example": "```typescript\nimport { createMediaSrcset, getDefaultSrc } from \"@ikas/bp-storefront\";\n\n// Product images can be videos — ALWAYS branch on isVideo when mapping media:\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\n      key={i}\n      src={getDefaultSrc(item)}\n      srcSet={createMediaSrcset(item)}\n      sizes=\"(max-width: 768px) 100vw, 50vw\"\n      alt={`Product ${i + 1}`}\n    />\n  )\n)}\n```",
       "categories": [
         "Image"
       ],
@@ -3085,6 +3099,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",
@@ -3177,14 +3220,14 @@
       "name": "getIkasOrderRefundableItems",
       "displayName": "getRefundableItems",
       "signature": "function getIkasOrderRefundableItems(order: IkasOrder): IkasOrderLineItem[]",
-      "description": "Returns order line items that are eligible for refund based on item status and the merchant's refund day limit settings.",
+      "description": "Returns order line items that are eligible for refund, based on the refundable lines returned by the API for the order.",
       "params": [
         {
           "name": "order",
           "description": "- The IkasOrder to retrieve refundable items from"
         }
       ],
-      "returns": "An array of order line items eligible for refund, or an empty array if refunds are disabled",
+      "returns": "An array of order line items eligible for refund, or an empty array if refundable lines are not loaded",
       "returnType": "IkasOrderLineItem[]",
       "example": "```typescript\nimport { getIkasOrderRefundableItems } from \"@ikas/bp-storefront\";\nconst refundableItems = getIkasOrderRefundableItems(order);\n```",
       "categories": [
@@ -3193,7 +3236,8 @@
       ],
       "related": [
         "isIkasOrderRefundable",
-        "getIkasOrderRefundedItems"
+        "getIkasOrderRefundedItems",
+        "getIkasOrderRefundReasons"
       ],
       "isAsync": false,
       "isClass": false,
@@ -3203,6 +3247,189 @@
         "IkasOrderLineItem"
       ]
     },
+    {
+      "name": "getIkasOrderRefundReasonId",
+      "displayName": "getRefundReasonId",
+      "signature": "function getIkasOrderRefundReasonId(order: IkasOrder): string | null",
+      "description": "Returns the selected refund reason id for the order's refund request.",
+      "params": [
+        {
+          "name": "order",
+          "description": "- The IkasOrder to read the selected refund reason id from"
+        }
+      ],
+      "returns": "The selected refund reason id, or null if none is selected",
+      "returnType": "string | null",
+      "example": "```typescript\nimport { getIkasOrderRefundReasonId } from \"@ikas/bp-storefront\";\nconst refundReasonId = getIkasOrderRefundReasonId(order);\n```",
+      "categories": [
+        "Order",
+        "Payment"
+      ],
+      "related": [
+        "setIkasOrderRefundReasonId",
+        "getIkasOrderRefundReasons"
+      ],
+      "isAsync": false,
+      "isClass": false,
+      "parameterTypes": [
+        "IkasOrderRefundReasonId",
+        "IkasOrder"
+      ]
+    },
+    {
+      "name": "setIkasOrderRefundReasonId",
+      "displayName": "setRefundReasonId",
+      "signature": "function setIkasOrderRefundReasonId(order: IkasOrder, value: string | null): void",
+      "description": "Sets the selected refund reason id that will be sent with the order's refund request.",
+      "params": [
+        {
+          "name": "order",
+          "description": "- The IkasOrder to set the refund reason id on"
+        },
+        {
+          "name": "value",
+          "description": "- The id of one of the reasons returned by getIkasOrderRefundReasons, or null to clear it"
+        }
+      ],
+      "returnType": "void",
+      "example": "```typescript\nimport { setIkasOrderRefundReasonId, getIkasOrderRefundReasons } from \"@ikas/bp-storefront\";\nconst [firstReason] = getIkasOrderRefundReasons(order);\nsetIkasOrderRefundReasonId(order, firstReason?.id || null);\n```",
+      "categories": [
+        "Order",
+        "Payment"
+      ],
+      "related": [
+        "getIkasOrderRefundReasonId",
+        "getIkasOrderRefundReasons",
+        "refundOrder"
+      ],
+      "isAsync": false,
+      "isClass": false,
+      "parameterTypes": [
+        "IkasOrderRefundReasonId",
+        "IkasOrder"
+      ]
+    },
+    {
+      "name": "getIkasOrderRefundReason",
+      "displayName": "getRefundReason",
+      "signature": "function getIkasOrderRefundReason(order: IkasOrder): string | null",
+      "description": "Returns the free-text refund reason written by the customer for the order's refund request.",
+      "params": [
+        {
+          "name": "order",
+          "description": "- The IkasOrder to read the refund reason note from"
+        }
+      ],
+      "returns": "The refund reason note, or null if none is set",
+      "returnType": "string | null",
+      "example": "```typescript\nimport { getIkasOrderRefundReason } from \"@ikas/bp-storefront\";\nconst reason = getIkasOrderRefundReason(order);\n```",
+      "categories": [
+        "Order",
+        "Payment"
+      ],
+      "related": [
+        "setIkasOrderRefundReason",
+        "getIkasOrderRefundReasonId"
+      ],
+      "isAsync": false,
+      "isClass": false,
+      "parameterTypes": [
+        "IkasOrderRefundReason",
+        "IkasOrder"
+      ]
+    },
+    {
+      "name": "setIkasOrderRefundReason",
+      "displayName": "setRefundReason",
+      "signature": "function setIkasOrderRefundReason(order: IkasOrder, value: string | null): void",
+      "description": "Sets the free-text refund reason that will be sent with the order's refund request.",
+      "params": [
+        {
+          "name": "order",
+          "description": "- The IkasOrder to set the refund reason note on"
+        },
+        {
+          "name": "value",
+          "description": "- The refund reason note, or null to clear it"
+        }
+      ],
+      "returnType": "void",
+      "example": "```typescript\nimport { setIkasOrderRefundReason } from \"@ikas/bp-storefront\";\nsetIkasOrderRefundReason(order, \"The product arrived damaged\");\n```",
+      "categories": [
+        "Order",
+        "Payment"
+      ],
+      "related": [
+        "getIkasOrderRefundReason",
+        "setIkasOrderRefundReasonId",
+        "refundOrder"
+      ],
+      "isAsync": false,
+      "isClass": false,
+      "parameterTypes": [
+        "IkasOrderRefundReason",
+        "IkasOrder"
+      ]
+    },
+    {
+      "name": "getIkasOrderRefundReasons",
+      "displayName": "getRefundReasons",
+      "signature": "function getIkasOrderRefundReasons(order: IkasOrder): IkasOrderRefundReason[]",
+      "description": "Returns the refund reasons the customer can choose from, with titles translated to the current locale.",
+      "params": [
+        {
+          "name": "order",
+          "description": "- The IkasOrder to get refund reasons for"
+        }
+      ],
+      "returns": "An array of refund reasons with localized titles, or an empty array if refundable lines are not loaded",
+      "returnType": "IkasOrderRefundReason[]",
+      "example": "```typescript\nimport { getIkasOrderRefundReasons } from \"@ikas/bp-storefront\";\nconst reasons = getIkasOrderRefundReasons(order);\nreasons.forEach(reason => console.log(reason.id, reason.title));\n```",
+      "categories": [
+        "Order",
+        "Payment"
+      ],
+      "related": [
+        "setIkasOrderRefundReasonId",
+        "getIkasOrderRefundableItems"
+      ],
+      "isAsync": false,
+      "isClass": false,
+      "parameterTypes": [
+        "IkasOrderRefundReasons",
+        "IkasOrder",
+        "IkasOrderRefundReason"
+      ]
+    },
+    {
+      "name": "getIkasOrderReturnMethodDescription",
+      "displayName": "getReturnMethodDescription",
+      "signature": "function getIkasOrderReturnMethodDescription(order: IkasOrder): string | null",
+      "description": "Returns the merchant's return method description for the current locale.",
+      "params": [
+        {
+          "name": "order",
+          "description": "- The IkasOrder to get the return method description for"
+        }
+      ],
+      "returns": "The return method description for the current locale, or null if none exists",
+      "returnType": "string | null",
+      "example": "```typescript\nimport { getIkasOrderReturnMethodDescription } from \"@ikas/bp-storefront\";\nconst description = getIkasOrderReturnMethodDescription(order);\n```",
+      "categories": [
+        "Order",
+        "Payment"
+      ],
+      "related": [
+        "getIkasOrderRefundReasons",
+        "getIkasOrderRefundableItems"
+      ],
+      "isAsync": false,
+      "isClass": false,
+      "parameterTypes": [
+        "IkasOrderReturnMethodDescription",
+        "IkasOrder"
+      ]
+    },
     {
       "name": "isIkasOrderRefundable",
       "displayName": "isRefundable",
@@ -4628,7 +4855,7 @@
       "name": "getIkasProductAttrributeProductIds",
       "displayName": "getProductIds",
       "signature": "function getIkasProductAttrributeProductIds(value: IkasProductAttributeValue): string[]",
-      "description": "Extracts and returns the product IDs from a PRODUCT-type attribute value's JSON string.",
+      "description": "Extracts and returns the product IDs from a PRODUCT-type attribute value's JSON string.\nNOTE: the export name really is misspelled — \"Attrribute\" with a double r. It is kept as-is because\nrenaming a published export would break every theme that imports it, so import it VERBATIM; the\ncorrectly spelled `getIkasProductAttributeProductIds` does not exist and will not compile. This is\nnot a documentation typo to report or \"fix\". In the blueprint editor the display alias is\n`getProductIds`, which hides the misspelling; only direct TypeScript imports see it.",
       "params": [
         {
           "name": "value",
@@ -5696,6 +5923,34 @@
         "IkasProductStockLocations"
       ]
     },
+    {
+      "name": "updateProductPrices",
+      "displayName": "updatePrices",
+      "signature": "async function updateProductPrices(product: IkasProduct): Promise<void>",
+      "description": "Re-fetch the latest variant prices of a product and apply them in place.\nUseful when the page is served from cache but prices change frequently (e.g. gold prices),\ncall it once the product is mounted on the browser.",
+      "params": [
+        {
+          "name": "product",
+          "description": "- The product to refresh prices for (modified in place)"
+        }
+      ],
+      "returns": "void",
+      "returnType": "Promise<void>",
+      "example": "```typescript\nimport { updateProductPrices } from \"@ikas/bp-storefront\";\n\nuseEffect(() => {\n  updateProductPrices(product);\n}, [product]);\n```",
+      "categories": [
+        "Product",
+        "Pricing"
+      ],
+      "related": [
+        "updateProductListPrices",
+        "getProductVariantFormattedFinalPrice"
+      ],
+      "isAsync": true,
+      "isClass": false,
+      "parameterTypes": [
+        "IkasProduct"
+      ]
+    },
     {
       "name": "getProductOptionSet",
       "signature": "async function getProductOptionSet(product: IkasProduct): Promise<boolean>",
@@ -7310,16 +7565,16 @@
       "name": "getProductVariantMainImage",
       "displayName": "getMainImage",
       "signature": "function getProductVariantMainImage(variant: IkasProductVariant): IkasProductImage | undefined",
-      "description": "Get the main/primary image for a product variant.",
+      "description": "Get the main/primary media item for a product variant.\n\nThe returned IkasProductImage may be a video (`isVideo === true`) — branch on it\nand render `<video>` instead of `<img>`.",
       "params": [
         {
           "name": "variant",
           "description": "- The product variant"
         }
       ],
-      "returns": "The first IkasProductImage of the variant, or undefined if no images. Access `.image` to get the IkasImage for CDN helpers.",
+      "returns": "The first IkasProductImage of the variant, or undefined if no images. Check `.isVideo` to decide between `<video>` and `<img>`, and access `.image` to get the IkasImage for CDN helpers.",
       "returnType": "IkasProductImage | undefined",
-      "example": "```typescript\nimport { getProductVariantMainImage, getSelectedProductVariant, getDefaultSrc } from \"@ikas/bp-storefront\";\nimport { IkasProduct } from \"@ikas/bp-storefront\";\n\nfunction ProductImage({ product }: { product: IkasProduct }) {\n  const variant = getSelectedProductVariant(product);\n  const productImage = getProductVariantMainImage(variant);\n  const image = productImage?.image;\n\n  if (!image) {\n    return <div className=\"no-image\">No image available</div>;\n  }\n\n  return <img src={getDefaultSrc(image)} alt={product.name} />;\n}\n```",
+      "example": "```typescript\nimport { getProductVariantMainImage, getSelectedProductVariant, getDefaultSrc, createMediaSrcset } from \"@ikas/bp-storefront\";\nimport { IkasProduct } from \"@ikas/bp-storefront\";\n\nfunction ProductImage({ product }: { product: IkasProduct }) {\n  const variant = getSelectedProductVariant(product);\n  const productImage = getProductVariantMainImage(variant);\n  const image = productImage?.image;\n\n  if (!image) {\n    return <div className=\"no-image\">No image available</div>;\n  }\n\n  // Media can be a video — branch on isVideo:\n  return productImage.isVideo ? (\n    <video src={getDefaultSrc(image)} muted playsInline loop>\n      <track kind=\"captions\" />\n    </video>\n  ) : (\n    <img src={getDefaultSrc(image)} srcSet={createMediaSrcset(image)} alt={product.name} />\n  );\n}\n```",
       "categories": [
         "ProductDetail",
         "ProductList"
@@ -7597,14 +7852,14 @@
       "name": "getProductVariantAppliedCampaignAmount",
       "displayName": "getAppliedCampaignAmount",
       "signature": "function getProductVariantAppliedCampaignAmount(variant: IkasProductVariant): IkasAppliedCampaignAmount | null",
-      "description": "Get the applied campaign discount amount details for a product variant, including type and formatted value.",
+      "description": "Get the applied campaign discount amount details for a product variant, including type and formatted value.\n\nHow the discount value is interpreted depends on `campaign.type`:\n- `\"FIXED_AMOUNT\"` → the value is an absolute money amount, returned in `formattedPrice` (e.g. \"$10.00\"); `discountPercentage` stays null.\n- `\"RATIO\"` → the value is a percentage, returned in `discountPercentage` (e.g. \"10\" for 10% off); `formattedPrice` stays null.\n\nBoth fixed and tiered campaigns are supported. For a tiered-discount campaign\n(`campaign.fixedDiscount` is null and the discount lives in `campaign.tieredDiscount.rules`),\nthe first tier's amount (`campaign.tieredDiscount.rules[0].amount`) is used, matching the storefront runtime.",
       "params": [
         {
           "name": "variant",
           "description": "- The product variant to check for applied campaigns"
         }
       ],
-      "returns": "An object with campaign type, formatted price, and discount percentage, or null if no campaign is applied",
+      "returns": "An object `{ type, formattedPrice, discountPercentage }` — `formattedPrice` is set for FIXED_AMOUNT campaigns, `discountPercentage` for RATIO campaigns (fixed and tiered alike); the other field stays null. Returns null if no campaign is applied.",
       "returnType": "IkasAppliedCampaignAmount | null",
       "example": "```typescript\nimport { getProductVariantAppliedCampaignAmount, getSelectedProductVariant } from \"@ikas/bp-storefront\";\nimport { IkasProduct } from \"@ikas/bp-storefront\";\n\nfunction CampaignInfo({ product }: { product: IkasProduct }) {\n  const variant = getSelectedProductVariant(product);\n  const campaignAmount = getProductVariantAppliedCampaignAmount(variant);\n\n  if (!campaignAmount) return null;\n\n  return (\n    <div>\n      {campaignAmount.type === \"RATIO\"\n        ? `${campaignAmount.discountPercentage}% off`\n        : `${campaignAmount.formattedPrice} off`}\n    </div>\n  );\n}\n```",
       "categories": [
@@ -7999,6 +8254,36 @@
         "IkasProductVariant"
       ]
     },
+    {
+      "name": "getProductVariantTieredDiscountProducts",
+      "displayName": "getTieredDiscountProducts",
+      "signature": "function getProductVariantTieredDiscountProducts(variant: IkasProductVariant): IkasTieredDiscountProduct[]",
+      "description": "Get the tiered-discount breakdown for a product variant, one entry per discount tier.\n\nA tiered discount defines multiple quantity tiers (`campaign.tieredDiscount.rules`), each with its own\namount and quantity range. This resolves every tier against the variant's price and returns the\nper-tier sell/final prices (both raw numbers and formatted strings), matching the storefront runtime.\nThe raw rules are `IkasProductTieredDiscountRule` (ranges may be null); this function returns the\nresolved `IkasTieredDiscountProduct` with normalized `{ min, max }` — use the resolved shape, not the raw rule.\n\n`sellPrice`/`finalPrice` (and their `formatted*` variants) are PER UNIT; the `*WithQuantity` fields are the\ntier total for buying the minimum quantity. A `\"FIXED_AMOUNT\"` discount is applied only to that total, so\nper-unit `finalPrice` equals `sellPrice` and the saving shows only in `finalPriceWithQuantity`.\n\nThe discount `amount` is interpreted by `campaign.type`: `\"RATIO\"` treats it as a percentage,\n`\"FIXED_AMOUNT\"` as an absolute money amount subtracted from the tier total. `amount`/`type` are\ninformational — the discount is already applied in the resolved `*Price` fields, so prefer those over\nrecomputing it yourself.\n\n`lineItemQuantityRange.min`/`max` are normalized numbers where `0` means \"unbounded\". In particular\n`max === 0` marks an open-ended top tier (e.g. \"6+\" with no upper limit) — render it as \"min+\" rather\nthan \"min–max\", and never treat `max` as a real quantity when it is `0`.\n\nEach tier's `salesChannelIds` lists the channels it targets (empty/null = all channels). Filter tiers\nagainst `IkasStorefrontConfig.salesChannelId` so only those valid for the current storefront are shown.\n\nReturns an empty array when the variant has no tiered-discount campaign, when a\n`PRODUCT_AND_VARIANT` filter excludes this variant, or when no tier defines a quantity range.",
+      "params": [
+        {
+          "name": "variant",
+          "description": "- The product variant to resolve tiered discounts for"
+        }
+      ],
+      "returns": "An array of tier objects (`amount`, `lineItemQuantityRange`, `type`, sell/final prices with their formatted variants, `salesChannelIds`), or an empty array if no tiered discount applies",
+      "returnType": "IkasTieredDiscountProduct[]",
+      "example": "```typescript\nimport {\n  getProductVariantTieredDiscountProducts,\n  getSelectedProductVariant,\n  IkasStorefrontConfig,\n} from \"@ikas/bp-storefront\";\nimport { IkasProduct } from \"@ikas/bp-storefront\";\n\nfunction TieredDiscountTable({ product }: { product: IkasProduct }) {\n  const variant = getSelectedProductVariant(product);\n  const tiers = getProductVariantTieredDiscountProducts(variant);\n  const salesChannelId = IkasStorefrontConfig.salesChannelId;\n\n  if (!tiers.length) return null;\n\n  return (\n    <ul>\n      {tiers.map((tier, i) => {\n        // A tier applies when it targets no channels or includes the current one\n        const scoped =\n          !tier.salesChannelIds?.length ||\n          (!!salesChannelId && tier.salesChannelIds.includes(salesChannelId));\n        if (!scoped) return null;\n\n        return (\n          <li key={i}>\n            Buy {tier.lineItemQuantityRange.min}+ → {tier.formattedFinalPriceWithQuantity}{\" \"}\n            <s>{tier.formattedSellPriceWithQuantity}</s>\n          </li>\n        );\n      })}\n    </ul>\n  );\n}\n```",
+      "categories": [
+        "Pricing",
+        "ProductVariant"
+      ],
+      "related": [
+        "getProductVariantAppliedCampaignAmount",
+        "getProductVariantCampaignOffersDiscountPercentage",
+        "getProductVariantFinalPrice"
+      ],
+      "isAsync": false,
+      "isClass": false,
+      "parameterTypes": [
+        "IkasProductVariant",
+        "IkasTieredDiscountProduct"
+      ]
+    },
     {
       "name": "getProductVariantIsBackInStockEnabled",
       "displayName": "isBackInStockEnabled",
@@ -9095,6 +9380,34 @@
         "IkasProductList"
       ]
     },
+    {
+      "name": "updateProductListPrices",
+      "displayName": "updatePrices",
+      "signature": "async function updateProductListPrices(list: IkasProductList): Promise<void>",
+      "description": "Re-fetches the latest variant prices of the products in the list and applies them in place.\nUseful when the page is served from cache but prices change frequently (e.g. gold prices),\ncall it once the list is mounted on the browser.",
+      "params": [
+        {
+          "name": "list",
+          "description": "- The product list to refresh prices for"
+        }
+      ],
+      "returns": "void",
+      "returnType": "Promise<void>",
+      "example": "```typescript\nimport { updateProductListPrices } from \"@ikas/bp-storefront\";\n\nuseEffect(() => {\n  updateProductListPrices(productList);\n}, [productList]);\n```",
+      "categories": [
+        "ProductList",
+        "Pricing"
+      ],
+      "related": [
+        "updateProductPrices",
+        "getProductListPage"
+      ],
+      "isAsync": true,
+      "isClass": false,
+      "parameterTypes": [
+        "IkasProductList"
+      ]
+    },
     {
       "name": "setSortType",
       "signature": "async function setSortType(list: IkasProductList, sortType: IkasProductListSortType): Promise<void>",
@@ -9556,7 +9869,7 @@
       "name": "initAddressForm",
       "displayName": "init",
       "signature": "async function initAddressForm(addressForm: AddressForm, address?: IkasCustomerAddress): Promise<void>",
-      "description": "Initializes an address form with default or existing address values, loads location data, and configures field settings.",
+      "description": "Initializes an address form with default or existing address values, loads location data, and configures field settings.\n\nAlso resolves `addressForm.addressFormat` for the selected country. That is an\n`AddressFormItem[][]` describing which fields the country uses and how they group into rows\n(outer array = rows, inner array = fields sharing a row), and it is the only correct source\nfor laying out an address form -- a hardcoded field list will be wrong for most countries.\nIt is empty until this promise resolves, and `setAddressFormCountry` re-resolves it, so\nrender from it rather than copying it into local state.",
       "params": [
         {
           "name": "addressForm",
@@ -9569,7 +9882,7 @@
       ],
       "returns": "A promise that resolves once the form is fully initialized, including country/state/city lists, field settings, checkout settings, and shipping zones.",
       "returnType": "Promise<void>",
-      "example": "```typescript\nimport { initAddressForm } from \"@ikas/bp-storefront\";\n\n// Initialize an empty address form\nawait initAddressForm(addressForm);\n\n// Initialize with an existing customer address for editing\nawait initAddressForm(addressForm, existingAddress);\n```",
+      "example": "```tsx\nimport { useEffect, useState } from \"preact/hooks\";\nimport {\n  type AddressForm,\n  type AddressFormItem,\n  initAddressForm,\n  setAddressFormFirstName,\n  setAddressFormLastName,\n  setAddressFormIdentityNumber,\n  setAddressFormAddressLine1,\n  setAddressFormAddressLine2,\n  setAddressFormPostalCode,\n  setAddressFormPhone,\n} from \"@ikas/bp-storefront\";\n\n// Initialize an empty address form\nawait initAddressForm(addressForm);\n\n// Initialize with an existing customer address for editing\nawait initAddressForm(addressForm, existingAddress);\n\n// addressFormat is empty until init resolves, so gate the render on it.\nconst [isLoading, setIsLoading] = useState(true);\nuseEffect(() => {\n  initAddressForm(addressForm, address).then(() => setIsLoading(false));\n}, []);\n\n// Every addressFormat key has a matching setter, each taking (addressForm, value).\n// The location keys (country, state, city, district, region) are omitted here: they\n// render as selects fed by addressForm.countryOptions / stateOptions / cityOptions /\n// districtOptions / regionOptions, and must fall back to a text input when the field\n// isFreeText or has no options.\nconst SETTERS: Partial<Record<AddressFormItem, (form: AddressForm, value: string) => void>> = {\n  firstName: setAddressFormFirstName,\n  lastName: setAddressFormLastName,\n  identityNumber: setAddressFormIdentityNumber,\n  addressLine1: setAddressFormAddressLine1,\n  addressLine2: setAddressFormAddressLine2,\n  postalCode: setAddressFormPostalCode,\n  phone: setAddressFormPhone,\n};\n\n// Render the country's own layout: outer array = rows, inner array = fields in that row.\n(addressForm.addressFormat ?? []).map((row) => {\n  // A field the country does not use is absent from the form object entirely.\n  const keys = row.filter((key) => addressForm[key] != null);\n  if (!keys.length) return null;\n\n  return (\n    <div className=\"address-row\" key={keys.join(\"-\")}>\n      {keys.map((key) => {\n        // Each entry is an IkasFormItem: value, label, placeholder, hasError, message.\n        const field = addressForm[key];\n        if (!field) return null; // already guaranteed by the filter above; narrows the type\n        return (\n          <label key={key}>\n            {field.label}\n            <input\n              value={field.value ?? \"\"}\n              placeholder={field.placeholder}\n              onInput={(e) => SETTERS[key]?.(addressForm, e.currentTarget.value)}\n            />\n            {field.hasError && <small>{field.message}</small>}\n          </label>\n        );\n      })}\n    </div>\n  );\n})\n```",
       "categories": [
         "Address",
         "Form",
@@ -10717,101 +11030,183 @@
       "isClass": false
     },
     {
-      "name": "initForgotPasswordForm",
+      "name": "initDeactivateCustomerForm",
       "displayName": "init",
-      "signature": "function initForgotPasswordForm(forgotPasswordForm: ForgotPasswordForm): void",
-      "description": "Initializes the forgot password form with default email field values, labels, and placeholders.",
+      "signature": "function initDeactivateCustomerForm(deactivateCustomerForm: DeactivateCustomerForm): void",
+      "description": "Initializes the deactivate customer form with default password field values, labels, and placeholders.",
       "params": [
         {
-          "name": "forgotPasswordForm",
-          "description": "- The forgot password form model to initialize"
+          "name": "deactivateCustomerForm",
+          "description": "- The deactivate customer form model to initialize"
         }
       ],
       "returns": "void",
       "returnType": "void",
-      "example": "```typescript\nimport { initForgotPasswordForm } from \"@ikas/bp-storefront\";\ninitForgotPasswordForm(forgotPasswordForm);\n```",
+      "example": "```typescript\nimport { initDeactivateCustomerForm } from \"@ikas/bp-storefront\";\ninitDeactivateCustomerForm(deactivateCustomerForm);\n```",
       "categories": [
         "Validation",
-        "ForgotPassword",
+        "DeactivateCustomer",
         "Form"
       ],
       "related": [
-        "setForgotPasswordFormEmail",
-        "submitForgotPasswordForm"
+        "setDeactivateCustomerFormPassword",
+        "submitDeactivateCustomerForm"
       ],
       "isAsync": false,
       "isClass": false
     },
     {
-      "name": "setForgotPasswordFormEmail",
-      "displayName": "setEmail",
-      "signature": "function setForgotPasswordFormEmail(forgotPasswordForm: ForgotPasswordForm, value: string): void",
-      "description": "Sets the email value on the forgot password form and re-validates if the form has already been submitted.",
+      "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": "forgotPasswordForm",
-          "description": "- The forgot password form model to update"
+          "name": "deactivateCustomerForm",
+          "description": "- The deactivate customer form model to update"
         },
         {
           "name": "value",
-          "description": "- The new email address string to set"
+          "description": "- The new password string to set"
         }
       ],
       "returns": "void",
       "returnType": "void",
-      "example": "```typescript\nimport { setForgotPasswordFormEmail } from \"@ikas/bp-storefront\";\nsetForgotPasswordFormEmail(forgotPasswordForm, \"user@example.com\");\n```",
+      "example": "```typescript\nimport { setDeactivateCustomerFormPassword } from \"@ikas/bp-storefront\";\nsetDeactivateCustomerFormPassword(deactivateCustomerForm, \"mySecurePassword123\");\n```",
       "categories": [
         "Validation",
-        "ForgotPassword",
+        "DeactivateCustomer",
         "Form"
       ],
       "related": [
-        "initForgotPasswordForm",
-        "submitForgotPasswordForm"
+        "initDeactivateCustomerForm",
+        "submitDeactivateCustomerForm"
       ],
       "isAsync": false,
       "isClass": false
     },
     {
-      "name": "submitForgotPasswordForm",
+      "name": "submitDeactivateCustomerForm",
       "displayName": "submit",
-      "signature": "async function submitForgotPasswordForm(forgotPasswordForm: ForgotPasswordForm): Promise<boolean>",
-      "description": "Validates and submits the forgot password form, sending a password reset request for the provided email address.",
+      "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": "forgotPasswordForm",
-          "description": "- The forgot password form model to submit"
+          "name": "deactivateCustomerForm",
+          "description": "- The deactivate customer form model to submit"
         }
       ],
-      "returns": "A promise that resolves to true if the password reset email was sent successfully, or false on validation error or API failure",
+      "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 { submitForgotPasswordForm } from \"@ikas/bp-storefront\";\nconst success = await submitForgotPasswordForm(forgotPasswordForm);\nif (success) {\n  console.log(\"Password reset email sent!\");\n}\n```",
+      "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",
-        "ForgotPassword",
+        "DeactivateCustomer",
         "Form"
       ],
       "related": [
-        "initForgotPasswordForm",
-        "setForgotPasswordFormEmail"
+        "initDeactivateCustomerForm",
+        "setDeactivateCustomerFormPassword"
       ],
       "isAsync": true,
       "isClass": false
     },
     {
-      "name": "initLoginForm",
+      "name": "initForgotPasswordForm",
       "displayName": "init",
-      "signature": "function initLoginForm(loginForm: LoginForm): void",
-      "description": "Initializes the login form with default email and password field values, labels, and placeholders.",
+      "signature": "function initForgotPasswordForm(forgotPasswordForm: ForgotPasswordForm): void",
+      "description": "Initializes the forgot password form with default email field values, labels, and placeholders.",
       "params": [
         {
-          "name": "loginForm",
-          "description": "- The login form model to initialize"
+          "name": "forgotPasswordForm",
+          "description": "- The forgot password form model to initialize"
         }
       ],
       "returns": "void",
       "returnType": "void",
-      "example": "```typescript\nimport { initLoginForm } from \"@ikas/bp-storefront\";\ninitLoginForm(loginForm);\n```",
+      "example": "```typescript\nimport { initForgotPasswordForm } from \"@ikas/bp-storefront\";\ninitForgotPasswordForm(forgotPasswordForm);\n```",
+      "categories": [
+        "Validation",
+        "ForgotPassword",
+        "Form"
+      ],
+      "related": [
+        "setForgotPasswordFormEmail",
+        "submitForgotPasswordForm"
+      ],
+      "isAsync": false,
+      "isClass": false
+    },
+    {
+      "name": "setForgotPasswordFormEmail",
+      "displayName": "setEmail",
+      "signature": "function setForgotPasswordFormEmail(forgotPasswordForm: ForgotPasswordForm, value: string): void",
+      "description": "Sets the email value on the forgot password form and re-validates if the form has already been submitted.",
+      "params": [
+        {
+          "name": "forgotPasswordForm",
+          "description": "- The forgot password form model to update"
+        },
+        {
+          "name": "value",
+          "description": "- The new email address string to set"
+        }
+      ],
+      "returns": "void",
+      "returnType": "void",
+      "example": "```typescript\nimport { setForgotPasswordFormEmail } from \"@ikas/bp-storefront\";\nsetForgotPasswordFormEmail(forgotPasswordForm, \"user@example.com\");\n```",
+      "categories": [
+        "Validation",
+        "ForgotPassword",
+        "Form"
+      ],
+      "related": [
+        "initForgotPasswordForm",
+        "submitForgotPasswordForm"
+      ],
+      "isAsync": false,
+      "isClass": false
+    },
+    {
+      "name": "submitForgotPasswordForm",
+      "displayName": "submit",
+      "signature": "async function submitForgotPasswordForm(forgotPasswordForm: ForgotPasswordForm): Promise<boolean>",
+      "description": "Validates and submits the forgot password form, sending a password reset request for the provided email address.",
+      "params": [
+        {
+          "name": "forgotPasswordForm",
+          "description": "- The forgot password form model to submit"
+        }
+      ],
+      "returns": "A promise that resolves to true if the password reset email was sent successfully, or false on validation error or API failure",
+      "returnType": "Promise<boolean>",
+      "example": "```typescript\nimport { submitForgotPasswordForm } from \"@ikas/bp-storefront\";\nconst success = await submitForgotPasswordForm(forgotPasswordForm);\nif (success) {\n  console.log(\"Password reset email sent!\");\n}\n```",
+      "categories": [
+        "Validation",
+        "ForgotPassword",
+        "Form"
+      ],
+      "related": [
+        "initForgotPasswordForm",
+        "setForgotPasswordFormEmail"
+      ],
+      "isAsync": true,
+      "isClass": false
+    },
+    {
+      "name": "initLoginForm",
+      "displayName": "init",
+      "signature": "function initLoginForm(loginForm: LoginForm): void",
+      "description": "Initializes the login form with default email and password field values, labels, and placeholders.",
+      "params": [
+        {
+          "name": "loginForm",
+          "description": "- The login form model to initialize"
+        }
+      ],
+      "returns": "void",
+      "returnType": "void",
+      "example": "```typescript\nimport { initLoginForm } from \"@ikas/bp-storefront\";\ninitLoginForm(loginForm);\n```",
       "categories": [
         "Validation",
         "Login",
@@ -12502,7 +12897,7 @@
     {
       "name": "setLocalization",
       "signature": "function setLocalization(baseStore: BaseStore, localeOption: IkasLocaleOption): void",
-      "description": "Switches the storefront to the routing associated with `localeOption` and redirects the browser\nto the equivalent URL under that routing.\n\nReads the routing directly from `localeOption.routing`, then performs a full-page redirect via\n`window.location.replace`. For CATEGORY/BRAND/PRODUCT pages, the localized slug from the page's\nmetadata translations is used when available; otherwise the visitor stays on the current path\n(with the current routing prefix swapped for the new one). Query string and hash are preserved.",
+      "description": "Switches the storefront to the routing associated with `localeOption` and redirects the browser\nto the equivalent URL under that routing.\n\nReads the routing directly from `localeOption.routing`, then performs a full-page redirect via\n`window.location.replace`. For CATEGORY/BRAND/PRODUCT pages, the localized slug from the page's\nmetadata translations is used when available; otherwise the visitor stays on the current path\n(with the current routing prefix swapped for the new one). Query string and hash are preserved.\n\nWhich one: `setLocalization` backs a country/region picker (`baseStore.localeOptions`, one entry per country;\nthe routing it leads to sets the language and the currency together). `setLanguage` backs a language-only picker\n(`baseStore.languageOptions`, one entry per routing). Both only switch the routing, so a header needs one of\nthem, not both side by side.",
       "params": [
         {
           "name": "baseStore",
@@ -12530,7 +12925,7 @@
     {
       "name": "setLanguage",
       "signature": "function setLanguage(baseStore: BaseStore, language: IkasLanguageOption): void",
-      "description": "Switches the storefront to the routing identified by `language` and redirects the browser to\nthe equivalent URL under that routing.\n\nLooks up the routing by `language.id`, then performs a full-page redirect via\n`window.location.replace`. For CATEGORY/BRAND/PRODUCT pages, the localized slug from the\npage's metadata translations is used when available; otherwise the visitor stays on the\ncurrent path (with the current routing prefix swapped for the new one). Query string and\nhash are preserved.",
+      "description": "Switches the storefront to the routing identified by `language` and redirects the browser to\nthe equivalent URL under that routing.\n\nLooks up the routing by `language.id`, then performs a full-page redirect via\n`window.location.replace`. For CATEGORY/BRAND/PRODUCT pages, the localized slug from the\npage's metadata translations is used when available; otherwise the visitor stays on the\ncurrent path (with the current routing prefix swapped for the new one). Query string and\nhash are preserved.\n\nWhich one: see `setLocalization` — a language-only picker uses this, a country/region picker (language and\ncurrency together) uses `setLocalization`; a header needs one of them, not both.",
       "params": [
         {
           "name": "baseStore",
@@ -12559,11 +12954,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": [
@@ -12574,11 +12985,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": [
@@ -12616,7 +13045,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",
@@ -12692,7 +13121,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",
@@ -12713,7 +13142,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"
       ],
@@ -13022,6 +13451,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>",
@@ -13301,6 +13761,171 @@
         "IkasCustomerStore"
       ]
     },
+    {
+      "name": "milesSmilesBind",
+      "signature": "async function milesSmilesBind(customerStore: IkasCustomerStore, redirect?: string | null): Promise<MilesSmilesBindResult>",
+      "description": "Start the Turkish Airlines Miles&Smiles account bind flow for the logged-in customer.\nOpens the THY login page in a popup; once THY confirms, the browser is sent to the\nikas bind callback and lands back on `redirect` with `milesSmilesStatus` query params\n(see handleMilesSmilesBind). Binding is required before miles can be spent at checkout.",
+      "params": [
+        {
+          "name": "customerStore",
+          "description": "- The customer store instance (customer must be logged in)"
+        },
+        {
+          "name": "redirect",
+          "description": "- Relative store path to land on after bind, e.g. \"/account\" or \"/checkout?id=...&step=payment\""
+        }
+      ],
+      "returns": "`isSuccess: true` when the bind hand-off started; otherwise an `errorCode`\nsuch as \"AUTHORIZATION_REQUIRED\" or \"MILES_SMILES_LOGIN_CANCELLED_OR_FAILED\"",
+      "returnType": "Promise<MilesSmilesBindResult>",
+      "example": "```typescript\nimport { customerStore, milesSmilesBind } from \"@ikas/bp-storefront\";\n\nasync function onLinkClick() {\n  const result = await milesSmilesBind(customerStore, \"/account\");\n  if (!result.isSuccess) showToast(result.errorCode || \"UNEXPECTED_ERROR\");\n}\n```",
+      "categories": [
+        "Customer",
+        "Miles&Smiles"
+      ],
+      "related": [
+        "handleMilesSmilesBind",
+        "getMilesSmilesLink",
+        "unlinkMilesSmiles",
+        "getMilesSmilesDetails"
+      ],
+      "isAsync": true,
+      "isClass": false,
+      "parameterTypes": [
+        "IkasCustomerStore"
+      ]
+    },
+    {
+      "name": "handleMilesSmilesBind",
+      "signature": "function handleMilesSmilesBind(clear: boolean = true): HandleMilesSmilesBindReturnType | null",
+      "description": "Read the Miles&Smiles bind result from the current URL after THY redirects back\n(`?milesSmilesStatus=success` or `?milesSmilesStatus=fail&milesSmilesError=CODE`).\nCall this on the landing page (account or checkout). The params are removed from the\nURL so a refresh does not repeat the same message.",
+      "params": [
+        {
+          "name": "clear",
+          "description": "- Remove the params from the URL with history.replaceState (default: true)"
+        }
+      ],
+      "returns": "The landing result, or null when the URL carries no bind result",
+      "returnType": "HandleMilesSmilesBindReturnType | null",
+      "example": "```typescript\nimport { handleMilesSmilesBind } from \"@ikas/bp-storefront\";\n\nuseEffect(() => {\n  const result = handleMilesSmilesBind();\n  if (result?.status === \"success\") showToast(\"Miles&Smiles account linked\");\n  if (result?.status === \"fail\") showToast(result.errorCode || \"Bind failed\");\n}, []);\n```",
+      "categories": [
+        "Customer",
+        "Miles&Smiles"
+      ],
+      "related": [
+        "milesSmilesBind",
+        "getMilesSmilesLink"
+      ],
+      "isAsync": false,
+      "isClass": false
+    },
+    {
+      "name": "getMilesSmilesLink",
+      "signature": "async function getMilesSmilesLink(customerStore: IkasCustomerStore): Promise<APIResponse<ExternalAccountLink | null>>",
+      "description": "Get the customer's durable Miles&Smiles link (TK membership number and link date).\nA link does not guarantee a live checkout session; when getMilesSmilesDetails returns\nMILES_SMILES_LOGIN_REQUIRED, run milesSmilesBind again.",
+      "params": [
+        {
+          "name": "customerStore",
+          "description": "- The customer store instance"
+        }
+      ],
+      "returns": "API response whose data is the link, or null when not linked",
+      "returnType": "Promise<APIResponse<ExternalAccountLink | null>>",
+      "example": "```typescript\nimport { customerStore, getMilesSmilesLink } from \"@ikas/bp-storefront\";\n\nconst response = await getMilesSmilesLink(customerStore);\nconst tkNumber = response.data?.externalId;\n```",
+      "categories": [
+        "Customer",
+        "Miles&Smiles"
+      ],
+      "related": [
+        "milesSmilesBind",
+        "unlinkMilesSmiles"
+      ],
+      "isAsync": true,
+      "isClass": false,
+      "parameterTypes": [
+        "IkasCustomerStore"
+      ]
+    },
+    {
+      "name": "unlinkMilesSmiles",
+      "signature": "async function unlinkMilesSmiles(customerStore: IkasCustomerStore): Promise<APIResponse<boolean>>",
+      "description": "Remove the customer's Miles&Smiles link. Also clears the server-side checkout\nsession token, so miles cannot be spent until the customer binds again.",
+      "params": [
+        {
+          "name": "customerStore",
+          "description": "- The customer store instance"
+        }
+      ],
+      "returns": "API response whose data is true on success",
+      "returnType": "Promise<APIResponse<boolean>>",
+      "example": "```typescript\nimport { customerStore, unlinkMilesSmiles } from \"@ikas/bp-storefront\";\n\nconst response = await unlinkMilesSmiles(customerStore);\nif (response.isSuccess) showToast(\"Miles&Smiles link removed\");\n```",
+      "categories": [
+        "Customer",
+        "Miles&Smiles"
+      ],
+      "related": [
+        "milesSmilesBind",
+        "getMilesSmilesLink"
+      ],
+      "isAsync": true,
+      "isClass": false,
+      "parameterTypes": [
+        "IkasCustomerStore"
+      ]
+    },
+    {
+      "name": "getMilesSmilesDetails",
+      "signature": "async function getMilesSmilesDetails(customerStore: IkasCustomerStore): Promise<APIResponse<MilesSmilesDetailsResponse | undefined>>",
+      "description": "Get the Miles&Smiles balance and member details for the payment step.\nRequires a recent bind; MILES_SMILES_LOGIN_REQUIRED means the short-lived session\nexpired and milesSmilesBind should be run again. MILES_SMILES_NOT_ENABLED and\nPAYMENT_GATEWAY_NOT_FOUND mean the Miles UI should be hidden.",
+      "params": [
+        {
+          "name": "customerStore",
+          "description": "- The customer store instance"
+        }
+      ],
+      "returns": "API response whose data holds availableMiles, memberId, firstName and lastName",
+      "returnType": "Promise<APIResponse<MilesSmilesDetailsResponse | undefined>>",
+      "example": "```typescript\nimport { customerStore, getMilesSmilesDetails } from \"@ikas/bp-storefront\";\n\nconst response = await getMilesSmilesDetails(customerStore);\nif (response.errorCodes.includes(\"MILES_SMILES_LOGIN_REQUIRED\")) {\n  await milesSmilesBind(customerStore, window.location.pathname + window.location.search);\n} else if (response.data) {\n  console.log(\"Available miles:\", response.data.availableMiles);\n}\n```",
+      "categories": [
+        "Customer",
+        "Miles&Smiles"
+      ],
+      "related": [
+        "milesSmilesBind",
+        "getMilesSmilesLink"
+      ],
+      "isAsync": true,
+      "isClass": false,
+      "parameterTypes": [
+        "IkasCustomerStore"
+      ]
+    },
+    {
+      "name": "isMilesSmilesTransaction",
+      "signature": "function isMilesSmilesTransaction(transaction: IkasOrderTransaction): boolean",
+      "description": "Check whether an order transaction is the Miles&Smiles leg of a multi-tender payment.\nSuch rows are written on the synthetic MILES_SMILES gateway and are not refundable from the storefront.",
+      "params": [
+        {
+          "name": "transaction",
+          "description": "- The order transaction to check"
+        }
+      ],
+      "returns": "True when the transaction is a Miles&Smiles SALE",
+      "returnType": "boolean",
+      "example": "```typescript\nimport { isMilesSmilesTransaction } from \"@ikas/bp-storefront\";\n\nconst label = isMilesSmilesTransaction(tx) ? \"Miles&Smiles\" : tx.paymentGatewayName;\n```",
+      "categories": [
+        "Customer",
+        "Orders",
+        "Miles&Smiles"
+      ],
+      "related": [
+        "getOrderTransactions"
+      ],
+      "isAsync": false,
+      "isClass": false,
+      "parameterTypes": [
+        "IkasOrderTransaction"
+      ]
+    },
     {
       "name": "deleteCustomerAddress",
       "signature": "async function deleteCustomerAddress(customerStore: IkasCustomerStore, address: IkasCustomerAddress): Promise<boolean>",
@@ -13333,6 +13958,44 @@
         "IkasCustomerAddress"
       ]
     },
+    {
+      "name": "createRefundRequest",
+      "signature": "async function createRefundRequest(customerStore: IkasCustomerStore, order: IkasOrder, email?: string | null): Promise<IkasRefundRequestResult>",
+      "description": "Submit a refund request for an order based on the refund quantities set on each line item,\nalong with the selected refund reason id and refund reason note set on the order.",
+      "params": [
+        {
+          "name": "customerStore",
+          "description": "- The customer store instance"
+        },
+        {
+          "name": "order",
+          "description": "- The order to request a refund for"
+        },
+        {
+          "name": "email",
+          "description": "- Optional email address for guest order refunds"
+        }
+      ],
+      "returns": "Object with isSuccess flag, errorCode on failure and the not allowed lines for REFUND_NOT_ALLOWED",
+      "returnType": "Promise<IkasRefundRequestResult>",
+      "example": "```typescript\nimport { customerStore, createRefundRequest, getOrder } from \"@ikas/bp-storefront\";\n\nasync function handleRefundRequest(orderId: string) {\n  const order = await getOrder(customerStore, orderId);\n  if (!order) return;\n\n  const result = await createRefundRequest(customerStore, order);\n  if (result.isSuccess) {\n    showToast(\"Refund request submitted\");\n  } else if (result.errorCode === \"REFUND_REASON_REQUIRED\") {\n    showToast(\"Please select a refund reason\");\n  } else {\n    showToast(\"Refund request failed\");\n  }\n}\n```",
+      "categories": [
+        "Customer"
+      ],
+      "related": [
+        "refundOrder",
+        "getOrder",
+        "setIkasOrderRefundReasonId",
+        "setIkasOrderRefundReason"
+      ],
+      "isAsync": true,
+      "isClass": false,
+      "parameterTypes": [
+        "IkasCustomerStore",
+        "IkasOrder",
+        "IkasRefundRequestResult"
+      ]
+    },
     {
       "name": "refundOrder",
       "signature": "async function refundOrder(customerStore: IkasCustomerStore, order: IkasOrder, email?: string | null): Promise<boolean>",
@@ -13358,6 +14021,7 @@
         "Customer"
       ],
       "related": [
+        "createRefundRequest",
         "getOrder",
         "getOrders",
         "getOrderRefundSettings"
@@ -13743,6 +14407,36 @@
         "IkasOrderTransaction"
       ]
     },
+    {
+      "name": "getOrderTransactionsWithPrices",
+      "signature": "async function getOrderTransactionsWithPrices(customerStore: IkasCustomerStore, params: GetOrderTransactionsWithPricesParams): Promise<ListOrderTransactionWithPricesResponse | null>",
+      "description": "Retrieve an order's payment transactions together with its payment totals\n(charged, refunded, remaining balance and refundable amounts).",
+      "params": [
+        {
+          "name": "customerStore",
+          "description": "- The customer store instance"
+        },
+        {
+          "name": "params",
+          "description": "- Parameters containing the orderId"
+        }
+      ],
+      "returns": "The order's transactions with price totals, or null if unavailable",
+      "returnType": "Promise<ListOrderTransactionWithPricesResponse | null>",
+      "example": "```typescript\nimport { customerStore, getOrderTransactionsWithPrices } from \"@ikas/bp-storefront\";\n\nasync function loadPaymentSummary(orderId: string) {\n  const result = await getOrderTransactionsWithPrices(customerStore, { orderId });\n  if (result) {\n    console.log(\"Charged:\", result.chargedAmount, \"Remaining:\", result.remainingBalance);\n  }\n}\n```",
+      "categories": [
+        "Customer"
+      ],
+      "related": [
+        "getOrderTransactions",
+        "getOrder"
+      ],
+      "isAsync": true,
+      "isClass": false,
+      "parameterTypes": [
+        "IkasCustomerStore"
+      ]
+    },
     {
       "name": "getFavoriteProducts",
       "signature": "async function getFavoriteProducts(customerStore: IkasCustomerStore): Promise<IkasProduct[]>",
@@ -13922,7 +14616,8 @@
       ],
       "related": [
         "hasCustomer",
-        "logout"
+        "logout",
+        "getDeactivateCustomerForm"
       ],
       "isAsync": true,
       "isClass": false,
@@ -14493,6 +15188,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",
@@ -14862,7 +15609,7 @@
     {
       "name": "getEmptyAddressForm",
       "signature": "function getEmptyAddressForm(customerStore: IkasCustomerStore): AddressForm",
-      "description": "Create and return a new, empty address form with validation, wrapped in MobX observability.",
+      "description": "Create and return a new, empty address form with validation, wrapped in MobX observability.\n\nUse this to create an address; use `getIkasCustomerAddressForm(address)` to edit an existing\none. It starts `initAddressForm` internally but does not await it, so await `initAddressForm`\nyourself when you need to know that the country layout (`addressFormat`) and the country/state/\ncity lists are ready to render.",
       "params": [
         {
           "name": "customerStore",
@@ -14871,14 +15618,16 @@
       ],
       "returns": "A new observable address form object with validated fields",
       "returnType": "AddressForm",
-      "example": "```typescript\nimport { customerStore, getEmptyAddressForm, saveCustomer } from \"@ikas/bp-storefront\";\n\nfunction AddAddressPage() {\n  const form = getEmptyAddressForm(customerStore);\n\n  const handleSave = async () => {\n    const customer = { ...customerStore.customer! };\n    customer.addresses = [...(customer.addresses || []), formToAddress(form)];\n    await saveCustomer(customerStore, customer);\n  };\n\n  return (\n    <form>\n      <input\n        value={form.addressLine1.value}\n        onChange={e => form.addressLine1.value = e.target.value}\n      />\n      <button onClick={handleSave}>Save Address</button>\n    </form>\n  );\n}\n```",
+      "example": "```tsx\nimport {\n  customerStore,\n  getEmptyAddressForm,\n  initAddressForm,\n  setAddressFormAddressLine1,\n  submitAddressForm,\n} from \"@ikas/bp-storefront\";\n\n// Create the form once, then await init before rendering the country-driven layout.\nconst [form] = useState(() => getEmptyAddressForm(customerStore));\nconst [isLoading, setIsLoading] = useState(true);\nuseEffect(() => {\n  initAddressForm(form).then(() => setIsLoading(false));\n}, []);\n\n// Always go through the setters. Assigning `form.addressLine1.value` directly skips\n// re-validation and the dependent-field resets the location setters perform.\nsetAddressFormAddressLine1(form, \"123 Main Street\");\n\n// submitAddressForm validates and saves the address onto the customer itself --\n// do not hand-build a customer object and call saveCustomer for this.\nconst ok = await submitAddressForm(form);\n```",
       "categories": [
         "Customer",
         "Address"
       ],
       "related": [
-        "deleteCustomerAddress",
-        "saveCustomer"
+        "initAddressForm",
+        "submitAddressForm",
+        "getIkasCustomerAddressForm",
+        "deleteCustomerAddress"
       ],
       "isAsync": false,
       "isClass": false,
@@ -14967,6 +15716,20 @@
       "isClass": true,
       "className": "I18n"
     },
+    {
+      "name": "t",
+      "signature": "function t(key: K & (K extends `ikas:${string}` ? IkasTextKey : unknown), [params]: UiTextArgs<[K][K extends unknown ? 0 : never]>): string",
+      "description": "The project's UI text `key` in the store's language, its `{{param}}`s filled; the key itself when no text has it.\n`ikas:<key>` reads the store's common texts instead (`t(\"ikas:validation.required\")`).\nTypes only: the code component build binds it to the project's own texts (this shared runtime has no `t`).",
+      "params": [],
+      "returnType": "string",
+      "categories": [],
+      "related": [],
+      "isAsync": false,
+      "isClass": false,
+      "parameterTypes": [
+        "IkasTextKey"
+      ]
+    },
     {
       "name": "Router.navigate",
       "signature": "static Router.navigate(path: string, shallow: boolean = false, newTab: boolean = false): void",
@@ -15116,6 +15879,128 @@
       "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",
+      "description": "Register the live global-variable object (`_g_`) so `getThemeSetting`/`getThemeSettings`\nreturn actual runtime values (constants, computed getters, and in-editor edits) instead\nof the serialized design-time defaults. Called by generated code, not by component authors.",
+      "params": [],
+      "returnType": "void",
+      "categories": [],
+      "related": [],
+      "isAsync": false,
+      "isClass": false
+    },
+    {
+      "name": "getThemeSettings",
+      "signature": "function getThemeSettings(): ThemeSetting[]",
+      "description": "All global variables (Theme Settings) defined for the theme.",
+      "params": [],
+      "returnType": "ThemeSetting[]",
+      "categories": [],
+      "related": [],
+      "isAsync": false,
+      "isClass": false
+    },
+    {
+      "name": "getThemeSetting",
+      "signature": "function getThemeSetting(name: string): ThemeSetting | undefined",
+      "description": "A single global variable by its stable key (`variableName`, e.g. `_6Q0KV7VGGM`).\nDiscover keys via  (each item carries a human `displayName`).\nThe returned `value` is the live blueprint value when available, else the default.\nIts shape is discriminated by `type` (see ); note an\nIMAGE setting's value is an image REFERENCE (no `.url`) — resolve with\n`getDefaultSrc`/`getSrc`. An ENUM setting's `value` is one of its enum's option VALUES\n(or null) and the setting also carries `enumTypeId` and `options` (`{ label: value }`);\nin a code component prefer the typed `themeValue(\"_key\")` from `./global-types`, which\nnarrows the value to the enum's union.",
+      "params": [],
+      "returnType": "ThemeSetting | undefined",
+      "categories": [],
+      "related": [],
+      "isAsync": false,
+      "isClass": false
+    },
+    {
+      "name": "getThemeSettingValue",
+      "signature": "function getThemeSettingValue(name: string): any",
+      "description": "Convenience: the resolved value of a global variable, or `undefined` if not found.",
+      "params": [],
+      "returnType": "any",
+      "categories": [],
+      "related": [],
+      "isAsync": false,
+      "isClass": false
+    },
+    {
+      "name": "getThemeColors",
+      "signature": "function getThemeColors(): RuntimeDesignToken[]",
+      "description": "Theme color tokens. Each carries a resolved value and a `var(--id)` CSS reference.",
+      "params": [],
+      "returnType": "RuntimeDesignToken[]",
+      "categories": [],
+      "related": [],
+      "isAsync": false,
+      "isClass": false
+    },
+    {
+      "name": "getThemeTypography",
+      "signature": "function getThemeTypography(): RuntimeTypographyToken[]",
+      "description": "Theme typography tokens (text styles). Apply `className` or read `resolved` CSS values.",
+      "params": [],
+      "returnType": "RuntimeTypographyToken[]",
+      "categories": [],
+      "related": [],
+      "isAsync": false,
+      "isClass": false
+    },
+    {
+      "name": "getThemeBreakpoints",
+      "signature": "function getThemeBreakpoints(): RuntimeBreakpointToken[]",
+      "description": "Theme responsive breakpoints (`{ id, width }`).",
+      "params": [],
+      "returnType": "RuntimeBreakpointToken[]",
+      "categories": [],
+      "related": [],
+      "isAsync": false,
+      "isClass": false
+    },
+    {
+      "name": "getThemeKeyframes",
+      "signature": "function getThemeKeyframes(): RuntimeKeyframeToken[]",
+      "description": "Theme keyframe/transition animations. Use `ref` as the CSS animation name.",
+      "params": [],
+      "returnType": "RuntimeKeyframeToken[]",
+      "categories": [],
+      "related": [],
+      "isAsync": false,
+      "isClass": false
+    },
+    {
+      "name": "getThemeColorSchemes",
+      "signature": "function getThemeColorSchemes(): RuntimeThemeColorSchemes",
+      "description": "Theme color schemes (palettes). Returns two PARALLEL lists with different jobs:\n- `schemes`: the color SLOTS as `{ id }` only — no colors and no display label live here at\n  runtime. A slot's human name is authoring-only (read it via the CLI/MCP `list-theme-globals`\n  or the editor); at runtime identify a slot solely by its `id`.\n- `values`: the actual palettes. A palette's colors live in its `colorsByScheme`\n  map, keyed by slot id → `{ resolved, cssVar }`.\n\nTo render swatches, iterate `values[].colorsByScheme` (the source of truth for\ncolors), NOT the top-level `schemes` array — `schemes` carries slot ids only, so\niterating it renders empty:\n\n  const { values } = getThemeColorSchemes();\n  values.forEach(palette =>\n    Object.entries(palette.colorsByScheme).forEach(([slotId, { resolved, cssVar }]) => {\n      // slotId → stable slot key, cssVar → live var() ref (prefer this), resolved → hex snapshot\n    })\n  );",
+      "params": [],
+      "returnType": "RuntimeThemeColorSchemes",
+      "categories": [],
+      "related": [],
+      "isAsync": false,
+      "isClass": false
+    },
     {
       "name": "isBrowser",
       "signature": "function isBrowser(yes?: () => void, no?: () => void): void",
@@ -15142,6 +16027,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>",
@@ -15196,6 +16113,55 @@
       "related": [],
       "isAsync": false,
       "isClass": false
+    },
+    {
+      "name": "PayWithIkas",
+      "signature": "function PayWithIkas({ product, quantity = 1, className, style }: PayWithIkasProps): VNode<ClassAttributes<HTMLIFrameElement> & { ref: MutableRef<HTMLIFrameElement | null>; title: string; ... 4 more ...; style: { ...; }; }> | null",
+      "description": "\"Pay with ikas\" (Hızlı Öde) fast-checkout button for the product detail page.\nDrop-in Preact component that renders the pay-with-ikas checkout iframe and\nwires up its whole message protocol, so a theme gets the one-click \"Hızlı Öde\"\nflow without owning any of the plumbing. Use it next to the add-to-cart button\non the product detail page.\n\nThe pay-with-ikas URL is read from `IkasStorefrontConfig.getPayWithIkasUrl()`;\nwhen the merchant has not enabled Pay with ikas the component renders nothing.\nThe add-to-cart-enabled state is tracked reactively via mobx `autorun`, so the\niframe stays in sync as the product's availability changes (e.g. variant\nselection). Clicking \"Hızlı Öde\" creates a temporary cart via\n`createPayWithIkasSession` and redirects to the returned pay URL.",
+      "params": [
+        {
+          "name": "product",
+          "description": "- The product to fast-checkout via Pay with ikas"
+        },
+        {
+          "name": "quantity",
+          "description": "- Quantity to purchase (defaults to 1)"
+        },
+        {
+          "name": "className",
+          "description": "- Optional CSS class applied to the iframe"
+        },
+        {
+          "name": "style",
+          "description": "- Optional inline styles applied to the iframe"
+        }
+      ],
+      "returnType": "VNode<ClassAttributes<HTMLIFrameElement> & { ref: MutableRef<HTMLIFrameElement | null>; title: string; ... 4 more ...; style: { ...; }; }> | null",
+      "example": "```tsx\nimport { PayWithIkas } from \"@ikas/bp-storefront\";\n\n// On the product detail page, alongside the add-to-cart button:\n<PayWithIkas product={product} quantity={quantity} />\n```",
+      "categories": [
+        "ProductDetail",
+        "Checkout"
+      ],
+      "related": [
+        "createPayWithIkasSession",
+        "isAddToCartEnabled"
+      ],
+      "isAsync": false,
+      "isClass": false,
+      "parameterTypes": [
+        "IkasProps"
+      ]
+    },
+    {
+      "name": "normalizeSvg",
+      "signature": "function normalizeSvg(svg: string, options: NormalizeSvgOptions): string",
+      "description": "Isomorphic, DOM-free normalization of a raw SVG markup string for render.\nSafe to call in SSR, browser, and node — pure string transforms only.",
+      "params": [],
+      "returnType": "string",
+      "categories": [],
+      "related": [],
+      "isAsync": false,
+      "isClass": false
     }
   ],
   "codeExamples": []