@ikas/code-components-mcp 2.8.0 → 2.9.0

package/data/section-templates/account-info-section/children/AccountFavorites/ikas-config-snippet.json

@@ -34,6 +34,19 @@
       "displayName": "Components",
       "type": "COMPONENT_LIST",
       "required": false,
+      "defaultValue": {
+        "components": [
+          {
+            "codeComponentId": "nb34u3yu-card-product-name"
+          },
+          {
+            "codeComponentId": "nb34u3yu-card-product-variants"
+          },
+          {
+            "codeComponentId": "nb34u3yu-card-product-price"
+          }
+        ]
+      },
       "privateVarMap": {
         "product": {
           "id": "pvm_1772803530689_1",

package/data/section-templates/account-info-section/children/AccountOrders/index.tsx

@@ -80,7 +80,7 @@ export function AccountOrders({
           <Button
             variant="primary"
             size="s"
-            onClick={() => Router.navigate("/")}
+            onClick={() => Router.navigateToPage("INDEX")}
           >
             {shopButtonText}
           </Button>

package/data/section-templates/account-info-section/ikas-config-snippet.json

@@ -50,6 +50,25 @@
       "displayName": "Components",
       "type": "COMPONENT_LIST",
       "required": false,
+      "defaultValue": {
+        "components": [
+          {
+            "codeComponentId": "nb34u3yu-account-info-content"
+          },
+          {
+            "codeComponentId": "nb34u3yu-account-orders"
+          },
+          {
+            "codeComponentId": "nb34u3yu-account-addresses"
+          },
+          {
+            "codeComponentId": "nb34u3yu-account-favorites"
+          },
+          {
+            "codeComponentId": "nb34u3yu-account-order-detail"
+          }
+        ]
+      },
       "filteredComponentIds": [
         "<id-of-AccountInfoContent>",
         "<id-of-AccountOrders>",

package/data/section-templates/add-to-cart/ikas-config-snippet.json

@@ -40,6 +40,10 @@
       "displayName": "Top Spacing",
       "type": "TYPE",
       "required": false,
+      "defaultValue": {
+        "value": 0,
+        "unit": "px"
+      },
       "groupId": "mobile",
       "typeId": "@ikas/bp-storefront-models-MarginTopStyleType"
     },
@@ -48,6 +52,10 @@
       "displayName": "Bottom Spacing",
       "type": "TYPE",
       "required": false,
+      "defaultValue": {
+        "value": 0,
+        "unit": "px"
+      },
       "groupId": "mobile",
       "typeId": "@ikas/bp-storefront-models-MarginBottomStyleType"
     },
@@ -56,6 +64,10 @@
       "displayName": "Top Spacing",
       "type": "TYPE",
       "required": false,
+      "defaultValue": {
+        "value": 0,
+        "unit": "px"
+      },
       "groupId": "desktop",
       "typeId": "@ikas/bp-storefront-models-MarginTopStyleType"
     },
@@ -64,6 +76,10 @@
       "displayName": "Bottom Spacing",
       "type": "TYPE",
       "required": false,
+      "defaultValue": {
+        "value": 0,
+        "unit": "px"
+      },
       "groupId": "desktop",
       "typeId": "@ikas/bp-storefront-models-MarginBottomStyleType"
     },
@@ -72,6 +88,7 @@
       "displayName": "Hide Quantity Selector",
       "type": "BOOLEAN",
       "required": false,
+      "defaultValue": false,
       "groupId": "settings"
     },
     {

package/data/section-templates/add-to-cart/utils/cartLimits.ts

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

package/data/section-templates/blog-home-section/ikas-config-snippet.json

@@ -56,6 +56,7 @@
       "displayName": "Aspect Ratio",
       "type": "ENUM",
       "required": false,
+      "defaultValue": "Square",
       "groupId": "image-settings",
       "enumTypeId": "{{ENUM_ID:AspectRatio}}"
     },
@@ -64,6 +65,7 @@
       "displayName": "Image Fit",
       "type": "ENUM",
       "required": false,
+      "defaultValue": "Cover",
       "groupId": "image-settings",
       "enumTypeId": "{{ENUM_ID:ObjectFit}}"
     },

package/data/section-templates/blog-home-section/index.tsx

@@ -6,6 +6,7 @@ import {
   hasBlogListPrevPage,
   hasBlogListNextPage,
   getIkasBlogCategoryHref,
+  withRoutePrefix,
 } from "@ikas/bp-storefront";
 import { observer } from "@ikas/component-utils";
 import { cx } from "../../utils/cx";
@@ -47,7 +48,7 @@ export function BlogHome({
         {categories.length > 0 && (
           <div className="kombos-blog-home__categories">
             <a
-              href="/blog"
+              href={withRoutePrefix("/blog")}
               className={cx(
                 "kombos-blog-home__cat-btn",
                 "text-sm-medium",

package/data/section-templates/blog-post-section/ikas-config-snippet.json

@@ -41,6 +41,7 @@
       "displayName": "Aspect Ratio",
       "type": "ENUM",
       "required": false,
+      "defaultValue": "Square",
       "groupId": "appearance",
       "enumTypeId": "{{ENUM_ID:AspectRatio}}"
     },
@@ -49,6 +50,7 @@
       "displayName": "Image Fit",
       "type": "ENUM",
       "required": false,
+      "defaultValue": "Cover",
       "groupId": "appearance",
       "enumTypeId": "{{ENUM_ID:ObjectFit}}"
     },

package/data/section-templates/blog-post-section/index.tsx

@@ -2,6 +2,7 @@ import {
   getIkasBlogFormattedDate,
   getIkasBlogCategoryHref,
   getDefaultSrc,
+  withRoutePrefix,
 } from "@ikas/bp-storefront";
 
 import { Props } from "./types";
@@ -31,8 +32,8 @@ export function BlogPost({
   const writerName = getFullName(blogPost.writer?.firstName, blogPost.writer?.lastName);
 
   const breadcrumbItems: BreadcrumbItem[] = [
-    { label: homeText, href: "/" },
-    { label: blogText, href: "/blog" },
+    { label: homeText, href: withRoutePrefix("/") },
+    { label: blogText, href: withRoutePrefix("/blog") },
   ];
   if (categoryName && categoryHref) {
     breadcrumbItems.push({ label: categoryName, href: categoryHref });

package/data/section-templates/bundle-products/ikas-config-snippet.json

@@ -16,6 +16,10 @@
       "displayName": "Top Spacing",
       "type": "TYPE",
       "required": false,
+      "defaultValue": {
+        "value": 0,
+        "unit": "px"
+      },
       "groupId": "mobile",
       "typeId": "@ikas/bp-storefront-models-MarginTopStyleType"
     },
@@ -24,6 +28,10 @@
       "displayName": "Bottom Spacing",
       "type": "TYPE",
       "required": false,
+      "defaultValue": {
+        "value": 0,
+        "unit": "px"
+      },
       "groupId": "mobile",
       "typeId": "@ikas/bp-storefront-models-MarginBottomStyleType"
     },
@@ -32,6 +40,10 @@
       "displayName": "Top Spacing",
       "type": "TYPE",
       "required": false,
+      "defaultValue": {
+        "value": 0,
+        "unit": "px"
+      },
       "groupId": "desktop",
       "typeId": "@ikas/bp-storefront-models-MarginTopStyleType"
     },
@@ -40,6 +52,10 @@
       "displayName": "Bottom Spacing",
       "type": "TYPE",
       "required": false,
+      "defaultValue": {
+        "value": 0,
+        "unit": "px"
+      },
       "groupId": "desktop",
       "typeId": "@ikas/bp-storefront-models-MarginBottomStyleType"
     },
@@ -48,6 +64,7 @@
       "displayName": "Furniture Bundle Mode",
       "type": "BOOLEAN",
       "required": false,
+      "defaultValue": false,
       "groupId": "settings"
     },
     {
@@ -55,6 +72,7 @@
       "displayName": "Disable Product Link",
       "type": "BOOLEAN",
       "required": false,
+      "defaultValue": false,
       "groupId": "settings"
     },
     {
@@ -86,6 +104,7 @@
       "displayName": "Aspect Ratio",
       "type": "ENUM",
       "required": false,
+      "defaultValue": "Square",
       "groupId": "appearance",
       "enumTypeId": "{{ENUM_ID:AspectRatio}}"
     },
@@ -94,6 +113,7 @@
       "displayName": "Image Fit",
       "type": "ENUM",
       "required": false,
+      "defaultValue": "Cover",
       "groupId": "appearance",
       "enumTypeId": "{{ENUM_ID:ObjectFit}}"
     }

package/data/section-templates/cart-section/components/EmptyState/index.tsx

@@ -12,7 +12,7 @@ export default function EmptyState({
   continueShoppingText,
 }: Props) {
   const handleContinueShopping = () => {
-    Router.navigate("/");
+    Router.navigateToPage("INDEX");
   };
 
   return (

package/data/section-templates/cart-section/sub-components/CartItem/index.tsx

@@ -19,6 +19,7 @@ import {
 } from "@ikas/bp-storefront";
 import { resolveAspectRatio, resolveObjectFit } from "../../utils/media";
 import { cx } from "../../utils/cx";
+import { useCartLineLimits } from "../../utils/cartLineLimits";
 import type { AspectRatio, ObjectFit } from "../../global-types";
 
 interface CartItemProps {
@@ -40,6 +41,10 @@ const CartItem = observer(function CartItem({
 }: CartItemProps) {
   const isPage = variant === "page";
 
+  // The line's IkasOrderLineVariant carries no salesChannels, so the per-cart
+  // quantity limits come from a batched product fetch shared across all lines.
+  const limits = useCartLineLimits(item.variant?.productId);
+
   // Lines a campaign added automatically (e.g. a "buy 1 get 1" gift) cannot be
   // edited or removed on their own, so render them read-only with a badge.
   const isAutoCreated =
@@ -180,6 +185,8 @@ const CartItem = observer(function CartItem({
               <QuantitySelector
                 size="sm"
                 value={item.quantity}
+                min={limits?.min ?? 1}
+                max={limits?.max}
                 onChange={(qty) => changeItemQuantity(item, qty)}
               />
             )}
@@ -227,6 +234,8 @@ const CartItem = observer(function CartItem({
                   <QuantitySelector
                     size="sm"
                     value={item.quantity}
+                    min={limits?.min ?? 1}
+                    max={limits?.max}
                     onChange={(qty) => changeItemQuantity(item, qty)}
                   />
                   <button

package/data/section-templates/cart-section/utils/cartLimits.ts

@@ -0,0 +1,24 @@
+import { IkasProduct, IkasStorefrontConfig } from "@ikas/bp-storefront";
+
+export interface CartQuantityLimits {
+  min: number;
+  max?: number;
+}
+
+/**
+ * Resolve the per-cart quantity limits for a product from its active sales
+ * channel. Falls back to a minimum of 1 and no maximum when the channel or its
+ * limits are not set. `addItemToCart` clamps to the same limits internally only
+ * when it creates a NEW cart line — incrementing an existing line goes through
+ * `changeItemQuantity`, which never clamps — so enforcing these in the stepper
+ * is the only guard that covers both paths.
+ */
+export function getProductCartLimits(product: IkasProduct): CartQuantityLimits {
+  const channel = product.salesChannels?.find(
+    (sc) => sc.id === IkasStorefrontConfig.salesChannelId,
+  );
+  return {
+    min: channel?.minQuantityPerCart ?? 1,
+    max: channel?.maxQuantityPerCart ?? undefined,
+  };
+}

package/data/section-templates/cart-section/utils/cartLineLimits.ts

@@ -0,0 +1,100 @@
+import { useEffect, useState } from "preact/hooks";
+import { baseStore, bs_searchProductsById } from "@ikas/bp-storefront";
+import { CartQuantityLimits, getProductCartLimits } from "./cartLimits";
+
+/**
+ * Per-cart quantity limits for cart lines.
+ *
+ * A cart line's `IkasOrderLineVariant` carries no `salesChannels`, so the
+ * min/max per-cart limits can only be read from the full `IkasProduct`. This
+ * store batch-fetches the line products with `bs_searchProductsById` (lines
+ * register their productId one by one; the ids are flushed as ONE request on
+ * the next tick) and maps the resolved limits by product id for the cart
+ * steppers to read. Each product is fetched at most once; results stay cached
+ * for the session.
+ */
+
+const limitsByProductId = new Map<string, CartQuantityLimits>();
+const requestedProductIds = new Set<string>();
+const listeners = new Set<() => void>();
+
+let pendingProductIds: string[] = [];
+let flushTimer: ReturnType<typeof setTimeout> | null = null;
+
+function emit() {
+  for (const listener of listeners) listener();
+}
+
+async function flush() {
+  flushTimer = null;
+  const batch = pendingProductIds;
+  pendingProductIds = [];
+
+  // bs_searchProductsById never throws — API/network failures resolve with
+  // isSuccess: false — so the retry unmark must live on the result check.
+  const result = await bs_searchProductsById(baseStore, { productIds: batch }).catch(
+    () => null,
+  );
+  if (!result?.isSuccess || !result.products) {
+    // Limits stay unenforced for now; unmark the batch so a later
+    // ensureCartLineLimits call (e.g. the next cart open) can retry.
+    for (const id of batch) requestedProductIds.delete(id);
+    return;
+  }
+
+  for (const product of result.products) {
+    limitsByProductId.set(product.id, getProductCartLimits(product));
+  }
+  emit();
+}
+
+/**
+ * Register a cart line's productId for limit resolution. Ids already requested
+ * are skipped; new ids are collected and fetched in a single batched request
+ * on the next tick, so per-line calls do not fan out into per-line requests.
+ */
+export function ensureCartLineLimits(productId: string) {
+  if (requestedProductIds.has(productId)) return;
+  requestedProductIds.add(productId);
+  pendingProductIds.push(productId);
+  if (!flushTimer) flushTimer = setTimeout(flush, 0);
+}
+
+/** Resolved limits for a product — undefined until the batch fetch lands. */
+export function getCartLineLimits(
+  productId: string | null | undefined,
+): CartQuantityLimits | undefined {
+  return productId ? limitsByProductId.get(productId) : undefined;
+}
+
+/** Subscribe to limit resolutions; returns the unsubscribe function. */
+export function subscribeCartLineLimits(listener: () => void) {
+  listeners.add(listener);
+  return () => {
+    listeners.delete(listener);
+  };
+}
+
+/**
+ * Hook: resolved limits for one cart line's product — undefined until the
+ * batched fetch lands. Encapsulates the subscription protocol so components
+ * cannot get the ordering wrong.
+ */
+export function useCartLineLimits(
+  productId: string | null | undefined,
+): CartQuantityLimits | undefined {
+  const [, setVersion] = useState(0);
+  const limits = getCartLineLimits(productId);
+  useEffect(() => {
+    if (!productId) return;
+    // Subscribe BEFORE registering the id: a batch already in flight can
+    // resolve between render and this effect, and its emit must not be missed.
+    const unsubscribe = subscribeCartLineLimits(() => setVersion((v) => v + 1));
+    ensureCartLineLimits(productId);
+    // Re-check once for a result that landed before the subscription armed —
+    // skipped when the arming render already saw it (no redundant re-render).
+    if (!limits && getCartLineLimits(productId)) setVersion((v) => v + 1);
+    return unsubscribe;
+  }, [productId]);
+  return limits;
+}

package/data/section-templates/category-images-section/children/CategoryImageItem/ikas-config-snippet.json

@@ -24,6 +24,7 @@
       "displayName": "Dark Overlay",
       "type": "BOOLEAN",
       "required": false,
+      "defaultValue": false,
       "groupId": "desktop"
     },
     {
@@ -39,6 +40,7 @@
       "displayName": "Image Fit",
       "type": "ENUM",
       "required": false,
+      "defaultValue": "Cover",
       "groupId": "desktop",
       "enumTypeId": "{{ENUM_ID:ObjectFit}}"
     },
@@ -61,6 +63,7 @@
       "displayName": "Dark Overlay",
       "type": "BOOLEAN",
       "required": false,
+      "defaultValue": false,
       "groupId": "mobile"
     },
     {
@@ -76,6 +79,7 @@
       "displayName": "Image Fit",
       "type": "ENUM",
       "required": false,
+      "defaultValue": "Cover",
       "groupId": "mobile",
       "enumTypeId": "{{ENUM_ID:ObjectFit}}"
     }

package/data/section-templates/category-images-section/ikas-config-snippet.json

@@ -18,6 +18,7 @@
       "displayName": "Title Color",
       "type": "COLOR",
       "required": false,
+      "defaultValue": "#14141a",
       "groupId": "content"
     },
     {
@@ -41,6 +42,7 @@
       "displayName": "Mobile Column Count",
       "type": "ENUM",
       "required": false,
+      "defaultValue": "One",
       "groupId": "appearance",
       "enumTypeId": "{{ENUM_ID:NumberOfColumns}}"
     },
@@ -49,6 +51,19 @@
       "displayName": "Categories",
       "type": "COMPONENT_LIST",
       "required": false,
+      "defaultValue": {
+        "components": [
+          {
+            "codeComponentId": "nb34u3yu-category-image-item"
+          },
+          {
+            "codeComponentId": "nb34u3yu-category-image-item"
+          },
+          {
+            "codeComponentId": "nb34u3yu-category-image-item"
+          }
+        ]
+      },
       "filteredComponentIds": [
         "<id-of-CategoryImageItem>"
       ]

package/data/section-templates/category-list-section/children/CardProductName/ikas-config-snippet.json

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

package/data/section-templates/category-list-section/ikas-config-snippet.json

@@ -111,6 +111,7 @@
       "displayName": "Show Filters",
       "type": "BOOLEAN",
       "required": false,
+      "defaultValue": false,
       "groupId": "filters"
     },
     {
@@ -118,6 +119,7 @@
       "displayName": "Show Search",
       "type": "BOOLEAN",
       "required": false,
+      "defaultValue": false,
       "groupId": "filters"
     },
     {
@@ -125,6 +127,7 @@
       "displayName": "Image Aspect Ratio",
       "type": "ENUM",
       "required": false,
+      "defaultValue": "Square",
       "groupId": "image-settings",
       "enumTypeId": "{{ENUM_ID:AspectRatio}}"
     },
@@ -133,6 +136,7 @@
       "displayName": "Image Fit",
       "type": "ENUM",
       "required": false,
+      "defaultValue": "Cover",
       "groupId": "image-settings",
       "enumTypeId": "{{ENUM_ID:ObjectFit}}"
     },
@@ -141,6 +145,7 @@
       "displayName": "Infinite Scroll",
       "type": "BOOLEAN",
       "required": false,
+      "defaultValue": false,
       "groupId": "pagination"
     },
     {
@@ -164,6 +169,7 @@
       "displayName": "Hide Add to Cart Button",
       "type": "BOOLEAN",
       "required": false,
+      "defaultValue": false,
       "groupId": "card-settings"
     },
     {
@@ -171,6 +177,19 @@
       "displayName": "Components",
       "type": "COMPONENT_LIST",
       "required": false,
+      "defaultValue": {
+        "components": [
+          {
+            "codeComponentId": "nb34u3yu-card-product-name"
+          },
+          {
+            "codeComponentId": "nb34u3yu-card-product-variants"
+          },
+          {
+            "codeComponentId": "nb34u3yu-card-product-price"
+          }
+        ]
+      },
       "privateVarMap": {
         "product": {
           "id": "pvm_1772808304776_3",
@@ -188,6 +207,7 @@
       "displayName": "Hide Breadcrumb",
       "type": "BOOLEAN",
       "required": false,
+      "defaultValue": false,
       "groupId": "appearance"
     },
     {
@@ -195,6 +215,7 @@
       "displayName": "Is This a Brand Page?",
       "type": "BOOLEAN",
       "required": false,
+      "defaultValue": false,
       "groupId": "data"
     },
     {

package/data/section-templates/category-list-section/index.tsx

@@ -21,6 +21,7 @@ import {
   searchProductList,
   getProductOptionSet,
   IkasComponentRenderer,
+  withRoutePrefix,
 } from "@ikas/bp-storefront";
 import { Props } from "./types";
 import ProductCard from "../../sub-components/ProductCard";
@@ -170,7 +171,7 @@ export function CategoryList(props: Props) {
     const path = getCategoryPath(category);
     if (path.length === 0) return [];
     return [
-      { label: homepageText, href: "/" } as BreadcrumbItem,
+      { label: homepageText, href: withRoutePrefix("/") } as BreadcrumbItem,
       ...path.map(
         (cat: any) =>
           ({

package/data/section-templates/component-renderer/additional/ProductDetail/index.tsx

@@ -6,6 +6,7 @@ import {
   IkasImage,
   isNotEmpty,
   IkasComponentRenderer,
+  withRoutePrefix,
 } from "@ikas/bp-storefront";
 import { Props } from "./types";
 import Breadcrumb from "../../sub-components/Breadcrumb";
@@ -42,7 +43,10 @@ export function ProductDetail(props: Props) {
       <div className="kombos-container kombos-pd__container">
         <Breadcrumb
           items={[
-            { label: homepageText, href: "/" } as BreadcrumbItem,
+            {
+              label: homepageText,
+              href: withRoutePrefix("/"),
+            } as BreadcrumbItem,
             ...(isNotEmpty(categoryPath)
               ? categoryPath.map(
                   (pathItem: any) =>

package/data/section-templates/component-renderer/ikas-config-snippet.json

@@ -10,6 +10,19 @@
       "displayName": "Components",
       "type": "COMPONENT_LIST",
       "required": false,
+      "defaultValue": {
+        "components": [
+          {
+            "codeComponentId": "nb34u3yu-announcements"
+          },
+          {
+            "codeComponentId": "nb34u3yu-navbar"
+          },
+          {
+            "codeComponentId": "nb34u3yu-cookie-bar"
+          }
+        ]
+      },
       "filteredComponentIds": [
         "<id-of-Navbar>",
         "<id-of-Announcements>",