@ikas/code-components-mcp 2.6.1 → 2.7.0

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

@@ -14,6 +14,8 @@ import {
   getOrderLineItemFormattedOverridenPriceWithQuantity,
   hasOrderLineItemDiscount,
   getOrderLineItemOverridenPriceWithQuantity,
+  cartStore,
+  isOrderLineItemAutoCreated,
 } from "@ikas/bp-storefront";
 import { resolveAspectRatio, resolveObjectFit } from "../../utils/media";
 import { cx } from "../../utils/cx";
@@ -25,6 +27,7 @@ interface CartItemProps {
   variant?: "sidebar" | "page";
   aspectRatio?: AspectRatio;
   objectFit?: ObjectFit;
+  giftLabel?: string;
 }
 
 const CartItem = observer(function CartItem({
@@ -33,9 +36,25 @@ const CartItem = observer(function CartItem({
   variant = "sidebar",
   aspectRatio,
   objectFit,
+  giftLabel = "Gift",
 }: CartItemProps) {
   const isPage = variant === "page";
 
+  // 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 =
+    !!cartStore.cart && isOrderLineItemAutoCreated(cartStore.cart, item);
+  const giftBadge = isAutoCreated ? (
+    <span className="kombos-cart-item__gift-badge text-xs-medium">
+      {giftLabel}
+    </span>
+  ) : null;
+  const staticQuantity = (
+    <span className="kombos-cart-item__qty-static text-sm-medium">
+      ×{item.quantity}
+    </span>
+  );
+
   const mediaStyle: Record<string, string> = {
     aspectRatio: resolveAspectRatio(aspectRatio),
     objectFit: resolveObjectFit(objectFit),
@@ -103,6 +122,7 @@ const CartItem = observer(function CartItem({
               <a href={href} className={nameClass}>
                 {item.variant?.name}
               </a>
+              {giftBadge}
               {variantValues.length > 0 && (
                 <p className="kombos-cart-item__variant-text text-sm-regular">
                   {variantValues
@@ -113,19 +133,22 @@ const CartItem = observer(function CartItem({
                 </p>
               )}
             </div>
-            <button
-              className="kombos-cart-item__remove"
-              onClick={() => onRemove(item)}
-              aria-label="Remove"
-            >
-              <TrashSVG />
-            </button>
+            {!isAutoCreated && (
+              <button
+                className="kombos-cart-item__remove"
+                onClick={() => onRemove(item)}
+                aria-label="Remove"
+              >
+                <TrashSVG />
+              </button>
+            )}
           </div>
         ) : (
           <>
             <a href={href} className={nameClass}>
               {item.variant?.name}
             </a>
+            {giftBadge}
 
             {variantValues.length > 0 && (
               <div className="kombos-cart-item__variants">
@@ -151,11 +174,15 @@ const CartItem = observer(function CartItem({
 
         {isPage ? (
           <div className="kombos-cart-item__bottom">
-            <QuantitySelector
-              size="sm"
-              value={item.quantity}
-              onChange={(qty) => changeItemQuantity(item, qty)}
-            />
+            {isAutoCreated ? (
+              staticQuantity
+            ) : (
+              <QuantitySelector
+                size="sm"
+                value={item.quantity}
+                onChange={(qty) => changeItemQuantity(item, qty)}
+              />
+            )}
             <div className="kombos-cart-item__prices">
               {hasDiscount && (
                 <span className="kombos-cart-item__original-price text-sm-regular-strike">
@@ -193,18 +220,24 @@ const CartItem = observer(function CartItem({
             </div>
 
             <div className="kombos-cart-item__actions">
-              <QuantitySelector
-                size="sm"
-                value={item.quantity}
-                onChange={(qty) => changeItemQuantity(item, qty)}
-              />
-              <button
-                className="kombos-cart-item__remove"
-                onClick={() => onRemove(item)}
-                aria-label="Remove"
-              >
-                <TrashSVG />
-              </button>
+              {isAutoCreated ? (
+                staticQuantity
+              ) : (
+                <>
+                  <QuantitySelector
+                    size="sm"
+                    value={item.quantity}
+                    onChange={(qty) => changeItemQuantity(item, qty)}
+                  />
+                  <button
+                    className="kombos-cart-item__remove"
+                    onClick={() => onRemove(item)}
+                    aria-label="Remove"
+                  >
+                    <TrashSVG />
+                  </button>
+                </>
+              )}
             </div>
           </>
         )}

package/data/section-templates/navigation/sub-components/CartItem/styles.css

@@ -168,3 +168,17 @@
   flex-shrink: 0;
 }
 
+/* Auto-created (campaign gift) line: badge + read-only quantity */
+.kombos-cart-item__gift-badge {
+  display: inline-flex;
+  align-self: flex-start;
+  padding: 0.125rem 0.5rem;
+  border-radius: 999px;
+  background: var(--kombos-gray-100);
+  color: var(--kombos-gray-500);
+}
+
+.kombos-cart-item__qty-static {
+  color: var(--kombos-gray-500);
+}
+

package/data/section-templates/navigation/sub-components/QuantitySelector/index.tsx

@@ -5,20 +5,27 @@ interface Props {
   value: number;
   onChange: (value: number) => void;
   size?: "default" | "sm";
+  min?: number;
+  max?: number;
 }
 
 export default function QuantitySelector({
   value,
   onChange,
   size = "default",
+  min = 1,
+  max,
 }: Props) {
+  const canDecrease = value > min;
+  const canIncrease = max == null || value < max;
+
   return (
     <div className={cx("kombos-pd__qty", size === "sm" && "kombos-pd__qty--sm")}>
       <button
         type="button"
         className="kombos-pd__qty-btn"
-        onClick={() => onChange(Math.max(1, value - 1))}
-        disabled={value <= 1}
+        onClick={() => onChange(Math.max(min, value - 1))}
+        disabled={!canDecrease}
         aria-label="Decrease quantity"
       >
         <MinusSVG />
@@ -31,7 +38,8 @@ export default function QuantitySelector({
       <button
         type="button"
         className="kombos-pd__qty-btn"
-        onClick={() => onChange(value + 1)}
+        onClick={() => onChange(max == null ? value + 1 : Math.min(max, value + 1))}
+        disabled={!canIncrease}
         aria-label="Increase quantity"
       >
         <PlusSVG />

package/data/section-templates/product-detail-section/children/ProductDetailAddToCart/index.tsx

@@ -10,13 +10,14 @@ import {
   IkasBundleSettings,
   IkasStorefrontConfig,
 } from "@ikas/bp-storefront";
-import { useState } from "preact/hooks";
+import { useEffect, useState } from "preact/hooks";
 import { Props } from "./types";
 import Button from "../../sub-components/Button";
 import QuantitySelector from "../../sub-components/QuantitySelector";
 import PayWithIkas from "./components/PayWithIkas";
 import { isBundleOutOfStock } from "../../utils/bundle";
 import { validateOptionSet } from "../../utils/optionSet";
+import { getProductCartLimits } from "../../utils/cartLimits";
 import { showToast } from "../../utils/toast";
 
 export function ProductDetailAddToCart({
@@ -37,6 +38,12 @@ export function ProductDetailAddToCart({
   const [quantity, setQuantity] = useState(1);
   const [isAddingToCart, setIsAddingToCart] = useState(false);
 
+  // Seed the quantity to the product's minimum-per-cart when the product changes.
+  useEffect(() => {
+    if (!product) return;
+    setQuantity(getProductCartLimits(product).min);
+  }, [product?.id]);
+
   if (!product) return null;
 
   const editLineID =
@@ -59,6 +66,8 @@ export function ProductDetailAddToCart({
 
   const isDisabled = isOutOfStock || isAddingToCart;
 
+  const { min: minQuantity, max: maxQuantity } = getProductCartLimits(product);
+
   const payWithIkasUrl = IkasStorefrontConfig.getPayWithIkasUrl();
   const routing = IkasStorefrontConfig.getCurrentRouting();
   const showPayWithIkas =
@@ -119,7 +128,12 @@ export function ProductDetailAddToCart({
     >
       <div className="kombos-pd-atc__actions">
         {!hideQuantityInput && !isOutOfStock && (
-          <QuantitySelector value={quantity} onChange={setQuantity} />
+          <QuantitySelector
+            value={quantity}
+            onChange={setQuantity}
+            min={minQuantity}
+            max={maxQuantity}
+          />
         )}
         <Button
           variant="primary"

package/data/section-templates/product-detail-section/children/ProductDetailBackInStock/components/BackInStockForm/index.tsx

@@ -0,0 +1,92 @@
+import {
+  IkasProductVariant,
+  getProductVariantBackInStockForm,
+  initBackInStockNotificationForm,
+  setBackInStockNotificationFormEmail,
+  submitBackInStockNotificationForm,
+} from "@ikas/bp-storefront";
+import { observer } from "@ikas/component-utils";
+import { useEffect } from "preact/hooks";
+import Button from "../../../../sub-components/Button";
+import Input from "../../../../sub-components/Input";
+import FormItem from "../../../../sub-components/FormItem";
+
+interface Props {
+  variant: IkasProductVariant;
+  description: string;
+  emailLabel: string;
+  submitButtonText: string;
+  submittingText: string;
+  errorMessage: string;
+  onSaved: () => void;
+}
+
+// observer() because it reads the MobX-backed notification form and must
+// re-render as the customer types and as the submit status flags change.
+const BackInStockForm = observer(function BackInStockForm({
+  variant,
+  description,
+  emailLabel,
+  submitButtonText,
+  submittingText,
+  errorMessage,
+  onSaved,
+}: Props) {
+  const form = getProductVariantBackInStockForm(variant);
+
+  // Initialize once per variant (resets fields + validation flags).
+  useEffect(() => {
+    initBackInStockNotificationForm(form, variant);
+  }, [form, variant]);
+
+  const emailHasError = !!form.email?.hasError;
+
+  const handleSubmit = async (e: Event) => {
+    e.preventDefault();
+    if (await submitBackInStockNotificationForm(form)) onSaved();
+  };
+
+  const handleEmailInput = (e: Event) =>
+    setBackInStockNotificationFormEmail(
+      form,
+      (e.target as HTMLInputElement).value,
+    );
+
+  return (
+    <form className="kombos-pd-bis__form" onSubmit={handleSubmit}>
+      {description && <p className="kombos-pd-bis__desc">{description}</p>}
+      <FormItem
+        label={emailLabel}
+        htmlFor="back-in-stock-email"
+        status={emailHasError ? "error" : "default"}
+        helper={emailHasError ? form.email?.message : undefined}
+      >
+        <Input
+          id="back-in-stock-email"
+          type="email"
+          value={form.email?.value ?? ""}
+          placeholder={form.email?.placeholder}
+          status={emailHasError ? "error" : "default"}
+          onInput={handleEmailInput}
+        />
+      </FormItem>
+      {form.isFailure && (
+        <p className="kombos-pd-bis__error">
+          {form.responseMessage || errorMessage}
+        </p>
+      )}
+      <Button
+        variant="primary"
+        size="s"
+        type="submit"
+        className="kombos-pd-bis__submit"
+        loading={form.isSubmitting}
+        disabled={form.isSubmitting}
+      >
+        {form.isSubmitting ? submittingText : submitButtonText}
+      </Button>
+    </form>
+  );
+});
+
+export default BackInStockForm;

package/data/section-templates/product-detail-section/children/ProductDetailBackInStock/ikas-config-snippet.json

@@ -0,0 +1,159 @@
+{
+  "id": "{{PROJECT_ID}}-product-detail-back-in-stock",
+  "name": "ProductDetailBackInStock",
+  "type": "component",
+  "entry": "./src/components/ProductDetailBackInStock/index.tsx",
+  "styles": "./src/components/ProductDetailBackInStock/styles.css",
+  "props": [
+    {
+      "name": "product",
+      "displayName": "Product",
+      "type": "PRODUCT",
+      "required": false
+    },
+    {
+      "name": "notifyButtonText",
+      "displayName": "Notify Button Text",
+      "type": "TEXT",
+      "required": false,
+      "defaultValue": "Notify Me When Available",
+      "groupId": "texts"
+    },
+    {
+      "name": "reminderSavedText",
+      "displayName": "Reminder Saved Text",
+      "type": "TEXT",
+      "required": false,
+      "defaultValue": "We'll notify you",
+      "groupId": "texts"
+    },
+    {
+      "name": "alreadySavedMessage",
+      "displayName": "Already Saved Message",
+      "type": "TEXT",
+      "required": false,
+      "defaultValue": "You're already on the list — we'll email you when it's back.",
+      "groupId": "texts"
+    },
+    {
+      "name": "savedMessage",
+      "displayName": "Saved Success Message",
+      "type": "TEXT",
+      "required": false,
+      "defaultValue": "Great! We'll email you when this product is back in stock.",
+      "groupId": "texts"
+    },
+    {
+      "name": "loginRequiredMessage",
+      "displayName": "Login Required Message",
+      "type": "TEXT",
+      "required": false,
+      "defaultValue": "Please sign in so we can notify you.",
+      "groupId": "texts"
+    },
+    {
+      "name": "errorMessage",
+      "displayName": "Error Message",
+      "type": "TEXT",
+      "required": false,
+      "defaultValue": "Something went wrong. Please try again.",
+      "groupId": "texts"
+    },
+    {
+      "name": "modalTitle",
+      "displayName": "Email Modal Title",
+      "type": "TEXT",
+      "required": false,
+      "defaultValue": "Notify me when available",
+      "groupId": "texts"
+    },
+    {
+      "name": "modalDescription",
+      "displayName": "Email Modal Description",
+      "type": "TEXT",
+      "required": false,
+      "defaultValue": "Enter your email and we'll let you know the moment this product is back in stock.",
+      "groupId": "texts"
+    },
+    {
+      "name": "emailLabel",
+      "displayName": "Email Field Label",
+      "type": "TEXT",
+      "required": false,
+      "defaultValue": "Email",
+      "groupId": "texts"
+    },
+    {
+      "name": "submitButtonText",
+      "displayName": "Submit Button Text",
+      "type": "TEXT",
+      "required": false,
+      "defaultValue": "Notify Me",
+      "groupId": "texts"
+    },
+    {
+      "name": "submittingText",
+      "displayName": "Submitting Text",
+      "type": "TEXT",
+      "required": false,
+      "defaultValue": "Saving...",
+      "groupId": "texts"
+    },
+    {
+      "name": "mobileMarginTop",
+      "displayName": "Top Spacing",
+      "type": "TYPE",
+      "required": false,
+      "groupId": "mobile",
+      "typeId": "@ikas/bp-storefront-models-MarginTopStyleType"
+    },
+    {
+      "name": "mobileMarginBottom",
+      "displayName": "Bottom Spacing",
+      "type": "TYPE",
+      "required": false,
+      "groupId": "mobile",
+      "typeId": "@ikas/bp-storefront-models-MarginBottomStyleType"
+    },
+    {
+      "name": "desktopMarginTop",
+      "displayName": "Top Spacing",
+      "type": "TYPE",
+      "required": false,
+      "groupId": "desktop",
+      "typeId": "@ikas/bp-storefront-models-MarginTopStyleType"
+    },
+    {
+      "name": "desktopMarginBottom",
+      "displayName": "Bottom Spacing",
+      "type": "TYPE",
+      "required": false,
+      "groupId": "desktop",
+      "typeId": "@ikas/bp-storefront-models-MarginBottomStyleType"
+    }
+  ],
+  "propGroups": [
+    {
+      "id": "appearance",
+      "name": "Appearance Settings",
+      "children": [
+        {
+          "id": "mobile",
+          "name": "Mobile View",
+          "description": "Margin settings for mobile devices"
+        },
+        {
+          "id": "desktop",
+          "name": "Desktop View",
+          "description": "Margin settings for desktop devices"
+        }
+      ],
+      "description": "Component mobile and desktop view settings"
+    },
+    {
+      "id": "texts",
+      "name": "Texts",
+      "description": "Button, status and modal texts"
+    }
+  ]
+}

package/data/section-templates/product-detail-section/children/ProductDetailBackInStock/index.tsx

@@ -0,0 +1,141 @@
+import {
+  getSelectedProductVariant,
+  hasProductStock,
+  hasProductVariantStock,
+  getProductVariantIsBackInStockEnabled,
+  getProductVariantIsBackInStockCustomerLoginRequired,
+  saveProductVariantBackInStockReminder,
+  getFormattedMarginTopSize,
+  getFormattedMarginBottomSize,
+  customerStore,
+  Router,
+} from "@ikas/bp-storefront";
+import { useEffect, useState } from "preact/hooks";
+import { Props } from "./types";
+import Button from "../../sub-components/Button";
+import Modal from "../../sub-components/Modal";
+import { showToast } from "../../utils/toast";
+import BackInStockForm from "./components/BackInStockForm";
+
+export function ProductDetailBackInStock({
+  product,
+  notifyButtonText = "Notify Me When Available",
+  reminderSavedText = "We'll notify you",
+  alreadySavedMessage = "You're already on the list — we'll email you when it's back.",
+  savedMessage = "Great! We'll email you when this product is back in stock.",
+  loginRequiredMessage = "Please sign in so we can notify you.",
+  errorMessage = "Something went wrong. Please try again.",
+  modalTitle = "Notify me when available",
+  modalDescription = "Enter your email and we'll let you know the moment this product is back in stock.",
+  emailLabel = "Email",
+  submitButtonText = "Notify Me",
+  submittingText = "Saving...",
+  mobileMarginTop,
+  mobileMarginBottom,
+  desktopMarginTop,
+  desktopMarginBottom,
+}: Props) {
+  const [isEmailModalOpen, setIsEmailModalOpen] = useState(false);
+  const [reminderSaved, setReminderSaved] = useState(false);
+
+  const selectedVariant = product
+    ? getSelectedProductVariant(product)
+    : undefined;
+
+  // Reset local UI state when the selected variant changes, seeding "saved"
+  // from the variant's own persisted reminder state.
+  useEffect(() => {
+    setReminderSaved(!!selectedVariant?.isBackInStockReminderSaved);
+    setIsEmailModalOpen(false);
+  }, [selectedVariant?.id]);
+
+  if (!product || !selectedVariant) return null;
+
+  // This component owns the notify-me flow only. Stay out of the way unless the
+  // variant is out of stock AND back-in-stock reminders are enabled for it.
+  const isOutOfStock =
+    !hasProductStock(product) || !hasProductVariantStock(selectedVariant);
+  if (!isOutOfStock || !getProductVariantIsBackInStockEnabled(selectedVariant)) {
+    return null;
+  }
+
+  // Login-required branch: register a logged-in customer immediately, otherwise
+  // send an anonymous visitor to login first.
+  const registerWithCustomerEmail = async () => {
+    const email = customerStore.customer?.email;
+    if (!email) {
+      showToast(loginRequiredMessage, "error");
+      Router.navigateToPage("LOGIN");
+      return;
+    }
+    const ok = await saveProductVariantBackInStockReminder(selectedVariant, email);
+    setReminderSaved(ok);
+    showToast(ok ? savedMessage : errorMessage, ok ? "success" : "error");
+  };
+
+  const handleNotifyClick = () => {
+    if (reminderSaved) {
+      showToast(alreadySavedMessage, "success");
+      return;
+    }
+    if (getProductVariantIsBackInStockCustomerLoginRequired(selectedVariant)) {
+      void registerWithCustomerEmail();
+      return;
+    }
+    // No login required: collect the email through the form.
+    setIsEmailModalOpen(true);
+  };
+
+  const handleFormSaved = () => {
+    setReminderSaved(true);
+    setIsEmailModalOpen(false);
+    showToast(savedMessage, "success");
+  };
+
+  return (
+    <div
+      className="kombos-pd-bis"
+      style={{
+        "--mobile-mt": getFormattedMarginTopSize(mobileMarginTop),
+        "--mobile-mb": getFormattedMarginBottomSize(mobileMarginBottom),
+        "--desktop-mt": getFormattedMarginTopSize(desktopMarginTop),
+        "--desktop-mb": getFormattedMarginBottomSize(desktopMarginBottom),
+      }}
+    >
+      {reminderSaved ? (
+        <div className="kombos-pd-bis__saved" aria-live="polite">
+          {reminderSavedText}
+        </div>
+      ) : (
+        <Button
+          variant="secondary"
+          size="s"
+          className="kombos-pd-bis__btn"
+          onClick={handleNotifyClick}
+        >
+          {notifyButtonText}
+        </Button>
+      )}
+
+      {isEmailModalOpen && (
+        <Modal
+          title={modalTitle}
+          onClose={() => setIsEmailModalOpen(false)}
+          footer={null}
+        >
+          <BackInStockForm
+            variant={selectedVariant}
+            description={modalDescription}
+            emailLabel={emailLabel}
+            submitButtonText={submitButtonText}
+            submittingText={submittingText}
+            errorMessage={errorMessage}
+            onSaved={handleFormSaved}
+          />
+        </Modal>
+      )}
+    </div>
+  );
+}
+
+export default ProductDetailBackInStock;

package/data/section-templates/product-detail-section/children/ProductDetailBackInStock/styles.css

@@ -0,0 +1,47 @@
+/* ===== ProductDetailBackInStock ===== */
+
+.kombos-pd-bis {
+  display: flex;
+  flex-direction: column;
+  gap: 0.75rem;
+  margin-top: var(--mobile-mt);
+  margin-bottom: var(--mobile-mb);
+}
+
+.kombos-pd-bis__btn {
+  width: 100%;
+}
+
+.kombos-pd-bis__saved {
+  padding: 0.75rem 1rem;
+  border: 1px solid var(--color-border, #e5e5e5);
+  border-radius: 0.5rem;
+  text-align: center;
+}
+
+.kombos-pd-bis__form {
+  display: flex;
+  flex-direction: column;
+  gap: 1rem;
+}
+
+.kombos-pd-bis__desc {
+  margin: 0;
+}
+
+.kombos-pd-bis__error {
+  margin: 0;
+  color: var(--color-danger, #d92d20);
+}
+
+.kombos-pd-bis__submit {
+  width: 100%;
+}
+
+/* ===== Desktop (>=1024px) ===== */
+@media (min-width: 1024px) {
+  .kombos-pd-bis {
+    margin-top: var(--desktop-mt, var(--mobile-mt));
+    margin-bottom: var(--desktop-mb, var(--mobile-mb));
+  }
+}