@ikas/code-components-mcp 1.4.0-beta.13 → 1.4.0-beta.131

package/data/storefront-api.json

@@ -1,5 +1,5 @@
 {
-  "generatedAt": "2026-05-20T13:40:14.987Z",
+  "generatedAt": "2026-07-21T11:46:32.982Z",
   "functions": [
     {
       "name": "apiListProductBrand",
@@ -2761,16 +2761,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 +2788,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 OR video at 180px resolution.\n\nWhen mapping over product media (IkasProductImage[]), some items are videos:\ncheck `item.isVideo` and render a `<video>` thumbnail (typically with a play\noverlay) instead of an `<img>` when it is true.",
       "params": [
         {
           "name": "image",
           "description": "- The image object to generate the thumbnail source URL for."
         }
       ],
-      "returns": "The CDN URL string for the image at 180px size.",
+      "returns": "The CDN URL string for the image or video at 180px size.",
       "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:\n{product.images.map((item, i) =>\n  item.isVideo ? (\n    <video key={i} src={getDefaultSrc(item)} muted preload=\"metadata\">\n      <track kind=\"captions\" />\n    </video>\n  ) : (\n    <img key={i} src={getThumbnailSrc(item)} sizes=\"112px\" alt={`Thumb ${i + 1}`} />\n  )\n)}\n```",
       "categories": [
         "Image"
       ],
@@ -2815,7 +2815,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 +2823,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 +2846,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 +2855,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"
       ],
@@ -7310,16 +7310,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 +7597,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 +7999,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.\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.\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\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 { getProductVariantTieredDiscountProducts, getSelectedProductVariant } 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\n  if (!tiers.length) return null;\n\n  return (\n    <ul>\n      {tiers.map((tier, i) => (\n        <li key={i}>\n          Buy {tier.lineItemQuantityRange.min}+ → {tier.formattedFinalPriceWithQuantity}{\" \"}\n          <s>{tier.formattedSellPriceWithQuantity}</s>\n        </li>\n      ))}\n    </ul>\n  );\n}\n```",
+      "categories": [
+        "Pricing",
+        "ProductVariant"
+      ],
+      "related": [
+        "getProductVariantAppliedCampaignAmount",
+        "getProductVariantCampaignOffersDiscountPercentage",
+        "getProductVariantFinalPrice"
+      ],
+      "isAsync": false,
+      "isClass": false,
+      "parameterTypes": [
+        "IkasProductVariant",
+        "IkasTieredDiscountProduct"
+      ]
+    },
     {
       "name": "getProductVariantIsBackInStockEnabled",
       "displayName": "isBackInStockEnabled",
@@ -9556,7 +9586,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 +9599,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",
@@ -12499,6 +12529,34 @@
       "isAsync": false,
       "isClass": false
     },
+    {
+      "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.",
+      "params": [
+        {
+          "name": "baseStore",
+          "description": "- The base store instance (used to read the current page type for slug\nresolution on detail pages)."
+        },
+        {
+          "name": "localeOption",
+          "description": "- The locale option the visitor selected. Render `baseStore.localeOptions`\nas a list (e.g. a country/region picker) and pass the chosen entry directly to this function."
+        }
+      ],
+      "returns": "void.",
+      "returnType": "void",
+      "example": "```tsx\nimport { setLocalization, baseStore } from \"@ikas/bp-storefront\";\n\nfunction LocalizationSwitcher() {\n  return (\n    <ul>\n      {baseStore.localeOptions.map(option => (\n        <li key={option.id}>\n          <button onClick={() => setLocalization(baseStore, option)}>\n            {option.countryName}\n          </button>\n        </li>\n      ))}\n    </ul>\n  );\n}\n```",
+      "categories": [
+        "BaseStore",
+        "Store"
+      ],
+      "related": [],
+      "isAsync": false,
+      "isClass": false,
+      "parameterTypes": [
+        "IkasLocaleOption"
+      ]
+    },
     {
       "name": "setLanguage",
       "signature": "function setLanguage(baseStore: BaseStore, language: IkasLanguageOption): void",
@@ -14834,7 +14892,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",
@@ -14843,14 +14901,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,
@@ -15088,6 +15148,105 @@
       "isClass": true,
       "className": "Router"
     },
+    {
+      "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`.",
+      "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",
@@ -15101,10 +15260,10 @@
     },
     {
       "name": "IkasComponentRenderer",
-      "signature": "function IkasComponentRenderer({\n  id: baseId,\n  components,\n  style,\n  className,\n  parentProps = EMPTY_OBJ,\n  map = EMPTY_OBJ,\n}: IkasComponentRendererProps): VNode<ClassAttributes<HTMLElement> & { id: string; dangerouslySetInnerHTML: { __html: string; }; style: { cssText?: string | null | undefined; length?: string | number | null | undefined; ... 496 more ...; zoom?: string | ... 2 more ... | undefined; }; className: string | undefined; }> | null",
+      "signature": "function IkasComponentRenderer({\n  id: baseId,\n  components,\n  style,\n  className,\n  parentProps = EMPTY_OBJ,\n  map = EMPTY_OBJ,\n}: IkasComponentRendererProps): VNode<ClassAttributes<HTMLDivElement> & { id: string; ref: MutableRef<HTMLDivElement | null>; dangerouslySetInnerHTML: { ...; }; style: { ...; }; className: string | undefined; }> | null",
       "description": "",
       "params": [],
-      "returnType": "VNode<ClassAttributes<HTMLElement> & { id: string; dangerouslySetInnerHTML: { __html: string; }; style: { cssText?: string | null | undefined; length?: string | number | null | undefined; ... 496 more ...; zoom?: string | ... 2 more ... | undefined; }; className: string | undefined; }> | null",
+      "returnType": "VNode<ClassAttributes<HTMLDivElement> & { id: string; ref: MutableRef<HTMLDivElement | null>; dangerouslySetInnerHTML: { ...; }; style: { ...; }; className: string | undefined; }> | null",
       "categories": [],
       "related": [],
       "isAsync": false,
@@ -15168,6 +15327,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": []