@ikas/component-cli 0.93.0 → 0.94.0

package/templates/create-full/src/sub-components/QuantitySelector/styles.css

@@ -0,0 +1,51 @@
+/* Qty — border ececed, rounded-6, px-12 py-10, gap-16 between items */
+.kombos-pd__qty {
+  display: flex;
+  align-items: center;
+  gap: 1rem;
+  border: 1px solid var(--kombos-gray-200);
+  border-radius: 6px;
+  padding: 0.5625rem 0.6875rem;
+}
+
+.kombos-pd__qty-btn {
+  min-width: 1.5rem;
+  min-height: 1.5rem;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  border: none;
+  background: none;
+  cursor: pointer;
+  font-size: 1rem;
+  color: var(--kombos-gray-900);
+  padding: 0;
+  margin: -0.75rem;
+  padding: 0.75rem;
+}
+
+.kombos-pd__qty-btn:hover:not(:disabled) {
+  color: var(--kombos-gray-700);
+}
+
+.kombos-pd__qty-btn:disabled {
+  color: var(--kombos-gray-300);
+  cursor: not-allowed;
+}
+
+.kombos-pd__qty-value {
+  min-width: 1.5rem;
+  text-align: center;
+  color: var(--kombos-gray-900);
+}
+
+/* Small size variant */
+.kombos-pd__qty--sm {
+  gap: 0.75rem;
+  padding: 0.4375rem 0.6875rem;
+}
+
+.kombos-pd__qty--sm .kombos-pd__qty-btn {
+  margin: -0.5rem;
+  padding: 0.5rem;
+}

package/templates/create-full/src/sub-components/ReviewCard/index.tsx

@@ -0,0 +1,103 @@
+import type { IkasCustomerReview } from "@ikas/bp-storefront";
+import {
+  getIkasCustomerReviewFormattedDate,
+  getThumbnailSrc,
+  getDefaultSrc,
+} from "@ikas/bp-storefront";
+import { cx } from "../../utils/cx";
+import { getFullName } from "../../utils/fullName";
+import StarRating from "../StarRating";
+import { ArrowBendUpLeftSVG } from "../icons";
+
+interface Props {
+  review: IkasCustomerReview;
+  merchantReplyLabel: string;
+  onImageClick?: (src: string, alt: string) => void;
+  className?: string;
+}
+
+export default function ReviewCard({
+  review,
+  merchantReplyLabel,
+  onImageClick,
+  className,
+}: Props) {
+  const name = getFullName(review.firstName, review.lastName);
+  const date = getIkasCustomerReviewFormattedDate(review);
+  const hasImages = review.images && review.images.length > 0;
+
+  return (
+    <article className={cx("kombos-review-card", className)}>
+      <div className="kombos-review-card__header">
+        <div className="kombos-review-card__meta">
+          {name && (
+            <span className="kombos-review-card__author text-sm-semibold">
+              {name}
+            </span>
+          )}
+          {date && (
+            <span className="kombos-review-card__date text-xs-regular">
+              {date}
+            </span>
+          )}
+        </div>
+        <StarRating value={review.star} size="sm" />
+      </div>
+
+      {review.title && (
+        <h4 className="kombos-review-card__title text-md-semibold">
+          {review.title}
+        </h4>
+      )}
+
+      {review.comment && (
+        <p className="kombos-review-card__comment text-sm-regular">
+          {review.comment}
+        </p>
+      )}
+
+      {hasImages && (
+        <div className="kombos-review-card__images">
+          {review.images?.map((image, i) => {
+            const thumbSrc = getThumbnailSrc(image);
+            const fullSrc = getDefaultSrc(image);
+
+            if (!thumbSrc) return null;
+
+            return (
+              <button
+                key={i}
+                type="button"
+                className="kombos-review-card__image-btn"
+                onClick={() =>
+                  onImageClick?.(fullSrc, review.title || "Review image")
+                }
+              >
+                <img
+                  src={thumbSrc}
+                  alt={image.altText || review.title || "Review image"}
+                  className="kombos-review-card__image"
+                  loading="lazy"
+                />
+              </button>
+            );
+          })}
+        </div>
+      )}
+
+      {review.reply && (
+        <div className="kombos-review-card__reply">
+          <div className="kombos-review-card__reply-header">
+            <ArrowBendUpLeftSVG />
+            <span className="kombos-review-card__reply-label text-xs-semibold">
+              {merchantReplyLabel}
+            </span>
+          </div>
+          <p className="kombos-review-card__reply-text text-sm-regular">
+            {review.reply}
+          </p>
+        </div>
+      )}
+    </article>
+  );
+}

package/templates/create-full/src/sub-components/ReviewCard/styles.css

@@ -0,0 +1,95 @@
+.kombos-review-card {
+  display: flex;
+  flex-direction: column;
+  gap: 0.5rem;
+  padding: 1.25rem 0;
+  border-bottom: 1px solid var(--kombos-gray-100);
+}
+
+.kombos-review-card:last-child {
+  border-bottom: none;
+}
+
+.kombos-review-card__header {
+  display: flex;
+  flex-direction: column;
+  gap: 0.375rem;
+}
+
+.kombos-review-card__meta {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+}
+
+.kombos-review-card__author {
+  color: var(--kombos-gray-900);
+}
+
+.kombos-review-card__date {
+  color: var(--kombos-gray-400);
+}
+
+.kombos-review-card__title {
+  color: var(--kombos-gray-900);
+  margin: 0;
+}
+
+.kombos-review-card__comment {
+  color: var(--kombos-gray-700);
+  margin: 0;
+}
+
+.kombos-review-card__images {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.5rem;
+  margin-top: 0.25rem;
+}
+
+.kombos-review-card__image-btn {
+  all: unset;
+  cursor: pointer;
+  border-radius: 6px;
+  overflow: hidden;
+  line-height: 0;
+}
+
+.kombos-review-card__image {
+  width: 4rem;
+  height: 4rem;
+  object-fit: cover;
+  border-radius: 6px;
+  transition: opacity 0.15s ease;
+}
+
+.kombos-review-card__image-btn:hover .kombos-review-card__image {
+  opacity: 0.8;
+}
+
+.kombos-review-card__reply {
+  display: flex;
+  flex-direction: column;
+  gap: 0.375rem;
+  margin-top: 0.5rem;
+  padding: 0.75rem;
+  border: 1px solid var(--kombos-gray-200);
+  border-radius: 8px;
+}
+
+.kombos-review-card__reply-header {
+  display: flex;
+  align-items: center;
+  gap: 0.375rem;
+  font-size: 0.875rem;
+  color: var(--kombos-gray-500);
+}
+
+.kombos-review-card__reply-label {
+  color: var(--kombos-gray-700);
+}
+
+.kombos-review-card__reply-text {
+  color: var(--kombos-gray-700);
+  margin: 0;
+}

package/templates/create-full/src/sub-components/ReviewForm/index.tsx

@@ -0,0 +1,115 @@
+import { observer } from "@ikas/component-utils";
+import type { IkasProduct } from "@ikas/bp-storefront";
+import {
+  getIkasProductCustomerReviewForm,
+  submitCustomerReviewForm,
+  setCustomerReviewFormStar,
+  setCustomerReviewFormTitle,
+  setCustomerReviewFormComment,
+} from "@ikas/bp-storefront";
+import { showToast } from "../../utils/toast";
+import FormItem from "../FormItem";
+import Input from "../Input";
+import Textarea from "../Textarea";
+import StarRating from "../StarRating";
+
+interface Props {
+  product: IkasProduct;
+  onSuccess: () => void;
+  titlePlaceholder: string;
+  commentPlaceholder: string;
+  starRequiredError: string;
+  errorMessage: string;
+}
+
+const ReviewForm = observer(function ReviewForm({
+  product,
+  onSuccess,
+  titlePlaceholder,
+  commentPlaceholder,
+  starRequiredError,
+  errorMessage,
+}: Props) {
+  const form = getIkasProductCustomerReviewForm(product);
+
+  const handleStarChange = (value: number) => {
+    setCustomerReviewFormStar(form, String(value));
+  };
+
+  const handleSubmit = async (e: Event) => {
+    e.preventDefault();
+
+    const success = await submitCustomerReviewForm(form);
+
+    if (success) {
+      onSuccess();
+    } else {
+      showToast(form.responseMessage || errorMessage, "error");
+    }
+  };
+
+  const starValue = Number(form.star.value) || 0;
+
+  return (
+    <form
+      id="review-form"
+      className="kombos-review-form"
+      onSubmit={handleSubmit}
+    >
+      <div className="kombos-review-form__field">
+        <FormItem
+          status={form.star.hasError ? "error" : "default"}
+          helper={
+            form.star.hasError
+              ? form.star.message || starRequiredError
+              : undefined
+          }
+        >
+          <StarRating
+            value={starValue}
+            interactive
+            onChange={handleStarChange}
+            size="md"
+          />
+        </FormItem>
+      </div>
+
+      <FormItem
+        label={form.title.label || undefined}
+        status={form.title.hasError ? "error" : "default"}
+        helper={form.title.hasError ? form.title.message : undefined}
+      >
+        <Input
+          placeholder={titlePlaceholder}
+          value={form.title.value}
+          onInput={(e) => {
+            setCustomerReviewFormTitle(
+              form,
+              (e.target as HTMLInputElement).value,
+            );
+          }}
+        />
+      </FormItem>
+
+      <FormItem
+        label={form.comment.label || undefined}
+        status={form.comment.hasError ? "error" : "default"}
+        helper={form.comment.hasError ? form.comment.message : undefined}
+      >
+        <Textarea
+          placeholder={commentPlaceholder}
+          value={form.comment.value}
+          onInput={(e) => {
+            setCustomerReviewFormComment(
+              form,
+              (e.target as HTMLTextAreaElement).value,
+            );
+          }}
+          rows={4}
+        />
+      </FormItem>
+    </form>
+  );
+});
+
+export default ReviewForm;

package/templates/create-full/src/sub-components/ReviewForm/styles.css

@@ -0,0 +1,11 @@
+.kombos-review-form {
+  display: flex;
+  flex-direction: column;
+  gap: 1rem;
+}
+
+.kombos-review-form__field {
+  display: flex;
+  flex-direction: column;
+  gap: 0.25rem;
+}

package/templates/create-full/src/sub-components/ReviewSummary/index.tsx

@@ -0,0 +1,65 @@
+import type { ComponentChildren } from "preact";
+import type { IkasProductStar } from "@ikas/bp-storefront";
+import { cx } from "../../utils/cx";
+import StarRating from "../StarRating";
+
+interface Props {
+  averageStar: number;
+  totalReview: number;
+  stars: IkasProductStar[];
+  reviewCountText: string;
+  action?: ComponentChildren;
+  className?: string;
+}
+
+export default function ReviewSummary({
+  averageStar,
+  totalReview,
+  stars,
+  reviewCountText,
+  action,
+  className,
+}: Props) {
+  return (
+    <div className={cx("kombos-review-summary", className)}>
+      <div className="kombos-review-summary__overview">
+        <span className="kombos-review-summary__average display-xs-semibold">
+          {averageStar.toFixed(1)}
+        </span>
+        <StarRating value={averageStar} size="md" />
+        <span className="kombos-review-summary__count text-sm-regular">
+          {reviewCountText.replace("{count}", String(totalReview))}
+        </span>
+      </div>
+
+      <div className="kombos-review-summary__bars">
+        {[5, 4, 3, 2, 1].map((starLevel) => {
+          const entry = stars.find((s) => s.star === starLevel);
+          const count = entry?.count ?? 0;
+          const percentage = totalReview > 0 ? (count / totalReview) * 100 : 0;
+
+          return (
+            <div key={starLevel} className="kombos-review-summary__bar-row">
+              <span className="kombos-review-summary__bar-label text-sm-medium">
+                {starLevel}
+              </span>
+              <div className="kombos-review-summary__bar-track">
+                <div
+                  className="kombos-review-summary__bar-fill"
+                  style={{ width: `${percentage}%` }}
+                />
+              </div>
+              <span className="kombos-review-summary__bar-count text-xs-regular">
+                {count}
+              </span>
+            </div>
+          );
+        })}
+      </div>
+
+      {action && (
+        <div className="kombos-review-summary__action">{action}</div>
+      )}
+    </div>
+  );
+}

package/templates/create-full/src/sub-components/ReviewSummary/styles.css

@@ -0,0 +1,86 @@
+.kombos-review-summary {
+  display: flex;
+  flex-direction: column;
+  gap: 1.5rem;
+  padding: 1.5rem 0;
+  border-bottom: 1px solid var(--kombos-gray-200);
+}
+
+@media (min-width: 768px) {
+  .kombos-review-summary {
+    flex-direction: row;
+    align-items: center;
+    gap: 3rem;
+  }
+}
+
+.kombos-review-summary__overview {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 0.25rem;
+  min-width: 8rem;
+}
+
+.kombos-review-summary__average {
+  color: var(--kombos-gray-900);
+}
+
+.kombos-review-summary__count {
+  color: var(--kombos-gray-500);
+  white-space: nowrap;
+}
+
+.kombos-review-summary__bars {
+  display: flex;
+  flex-direction: column;
+  gap: 0.5rem;
+  flex: 1;
+  width: 100%;
+}
+
+.kombos-review-summary__bar-row {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+}
+
+.kombos-review-summary__bar-label {
+  color: var(--kombos-gray-700);
+  min-width: 0.75rem;
+  text-align: center;
+}
+
+.kombos-review-summary__bar-track {
+  flex: 1;
+  height: 0.5rem;
+  background: var(--kombos-gray-100);
+  border-radius: 4px;
+  overflow: hidden;
+}
+
+.kombos-review-summary__bar-fill {
+  height: 100%;
+  background: var(--kombos-gray-900);
+  border-radius: 4px;
+  transition: width 0.3s ease;
+}
+
+.kombos-review-summary__bar-count {
+  color: var(--kombos-gray-500);
+  min-width: 1.5rem;
+  text-align: right;
+}
+
+.kombos-review-summary__action {
+  display: flex;
+  align-items: flex-start;
+  margin-left: auto;
+}
+
+@media (max-width: 767px) {
+  .kombos-review-summary__action {
+    width: 100%;
+    justify-content: center;
+  }
+}

package/templates/create-full/src/sub-components/Select/index.tsx

@@ -0,0 +1,86 @@
+import { CSSProperties } from "preact";
+import { cx } from "../../utils/cx";
+import { CaretDownSVG, XCircleSVG } from "../icons";
+
+type Size = "xs" | "s" | "m";
+
+interface Option {
+  label: string;
+  value: string;
+}
+
+interface Props {
+  options: Option[];
+  size?: Size;
+  status?: "default" | "error" | "success";
+  value?: string;
+  onChange?: (e: Event) => void;
+  onClear?: () => void;
+  allowClear?: boolean;
+  className?: string;
+  style?: CSSProperties;
+  disabled?: boolean;
+  id?: string;
+  "aria-label"?: string;
+}
+
+const typographyClass: Record<Size, string> = {
+  xs: "text-sm-semibold",
+  s: "text-md-semibold",
+  m: "text-lg-semibold",
+};
+
+export default function Select({
+  options,
+  size = "s",
+  status = "default",
+  value,
+  onChange,
+  onClear,
+  allowClear,
+  className,
+  disabled,
+  id,
+  style,
+  "aria-label": ariaLabel,
+}: Props) {
+  const showClear = allowClear && !!value && !disabled;
+
+  const cls = cx(
+    "kombos-select",
+    `kombos-select--${size}`,
+    showClear && "kombos-select--clearable",
+    typographyClass[size],
+    className,
+  );
+
+  return (
+    <div className="kombos-select-wrap" style={style} data-state={status !== "default" ? status : undefined}>
+      <select
+        id={id}
+        className={cls}
+        value={value}
+        onChange={onChange}
+        disabled={disabled}
+        aria-label={ariaLabel}
+      >
+        {options.map((opt) => (
+          <option key={opt.value} value={opt.value}>
+            {opt.label}
+          </option>
+        ))}
+      </select>
+      <CaretDownSVG className="kombos-select__icon" />
+      {showClear && (
+        <button
+          type="button"
+          className="kombos-select__clear"
+          onClick={onClear}
+          aria-label="Clear selection"
+        >
+          <XCircleSVG />
+        </button>
+      )}
+    </div>
+  );
+}