@ikas/code-components-mcp 1.4.0-beta.2 → 1.4.0-beta.200

package/data/section-templates/product-detail-section/children/ProductDetailAddToCart/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/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,175 @@
+{
+  "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,
+      "defaultValue": {
+        "value": 0,
+        "unit": "px"
+      },
+      "groupId": "mobile",
+      "typeId": "@ikas/bp-storefront-models-MarginTopStyleType"
+    },
+    {
+      "name": "mobileMarginBottom",
+      "displayName": "Bottom Spacing",
+      "type": "TYPE",
+      "required": false,
+      "defaultValue": {
+        "value": 0,
+        "unit": "px"
+      },
+      "groupId": "mobile",
+      "typeId": "@ikas/bp-storefront-models-MarginBottomStyleType"
+    },
+    {
+      "name": "desktopMarginTop",
+      "displayName": "Top Spacing",
+      "type": "TYPE",
+      "required": false,
+      "defaultValue": {
+        "value": 0,
+        "unit": "px"
+      },
+      "groupId": "desktop",
+      "typeId": "@ikas/bp-storefront-models-MarginTopStyleType"
+    },
+    {
+      "name": "desktopMarginBottom",
+      "displayName": "Bottom Spacing",
+      "type": "TYPE",
+      "required": false,
+      "defaultValue": {
+        "value": 0,
+        "unit": "px"
+      },
+      "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));
+  }
+}

package/data/section-templates/product-detail-section/children/ProductDetailBackInStock/types.ts

@@ -0,0 +1,25 @@
+// This file is auto-generated — do not edit manually.
+import type {
+  IkasProduct,
+  MarginTopStyleType,
+  MarginBottomStyleType,
+} from "@ikas/bp-storefront";
+
+export interface Props {
+  product?: IkasProduct | null;
+  notifyButtonText?: string;
+  reminderSavedText?: string;
+  alreadySavedMessage?: string;
+  savedMessage?: string;
+  loginRequiredMessage?: string;
+  errorMessage?: string;
+  modalTitle?: string;
+  modalDescription?: string;
+  emailLabel?: string;
+  submitButtonText?: string;
+  submittingText?: string;
+  mobileMarginTop?: MarginTopStyleType;
+  mobileMarginBottom?: MarginBottomStyleType;
+  desktopMarginTop?: MarginTopStyleType;
+  desktopMarginBottom?: MarginBottomStyleType;
+}

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

@@ -80,6 +80,10 @@
       "displayName": "Top Spacing",
       "type": "TYPE",
       "required": false,
+      "defaultValue": {
+        "value": 0,
+        "unit": "px"
+      },
       "groupId": "mobile",
       "typeId": "@ikas/bp-storefront-models-MarginTopStyleType"
     },
@@ -88,6 +92,10 @@
       "displayName": "Bottom Spacing",
       "type": "TYPE",
       "required": false,
+      "defaultValue": {
+        "value": 0,
+        "unit": "px"
+      },
       "groupId": "mobile",
       "typeId": "@ikas/bp-storefront-models-MarginBottomStyleType"
     },
@@ -96,6 +104,10 @@
       "displayName": "Top Spacing",
       "type": "TYPE",
       "required": false,
+      "defaultValue": {
+        "value": 0,
+        "unit": "px"
+      },
       "groupId": "desktop",
       "typeId": "@ikas/bp-storefront-models-MarginTopStyleType"
     },
@@ -104,6 +116,10 @@
       "displayName": "Bottom Spacing",
       "type": "TYPE",
       "required": false,
+      "defaultValue": {
+        "value": 0,
+        "unit": "px"
+      },
       "groupId": "desktop",
       "typeId": "@ikas/bp-storefront-models-MarginBottomStyleType"
     },
@@ -112,6 +128,7 @@
       "displayName": "Aspect Ratio",
       "type": "ENUM",
       "required": false,
+      "defaultValue": "Square",
       "groupId": "appearance",
       "enumTypeId": "{{ENUM_ID:AspectRatio}}"
     },
@@ -120,6 +137,7 @@
       "displayName": "Image Fit",
       "type": "ENUM",
       "required": false,
+      "defaultValue": "Cover",
       "groupId": "appearance",
       "enumTypeId": "{{ENUM_ID:ObjectFit}}"
     }