@mohasinac/appkit 4.33.0 → 4.34.0

package/dist/features/media/upload/MediaUploadList.d.ts

@@ -7,6 +7,21 @@ export interface MediaUploadListProps {
     accept?: string;
     maxSizeMB?: number;
     maxItems?: number;
+    /**
+     * Per-TYPE ceilings, counted separately.
+     *
+     * `maxItems` alone cannot express "10 images and 1 video" — it is one
+     * number over a mixed list, so a buyer-facing rule of that shape had to be
+     * enforced by splitting the control in two, which is why product forms
+     * carried a gallery AND a separate single-video field that wrote a
+     * different part of the document.
+     *
+     * When either is set the matching type is counted on its own and `maxItems`
+     * becomes the overall backstop. Existing callers that pass neither are
+     * completely unaffected.
+     */
+    maxImages?: number;
+    maxVideos?: number;
     disabled?: boolean;
     helperText?: string;
     /**
@@ -23,4 +38,4 @@ export interface MediaUploadListProps {
      */
     isPersisted?: boolean;
 }
-export declare function MediaUploadList({ label, value, onChange, onUpload, accept, maxSizeMB, maxItems, disabled, helperText, onAbort, onStagedUrlsChange, isPersisted, }: MediaUploadListProps): import("react").JSX.Element;
+export declare function MediaUploadList({ label, value, onChange, onUpload, accept, maxSizeMB, maxItems, maxImages, maxVideos, disabled, helperText, onAbort, onStagedUrlsChange, isPersisted, }: MediaUploadListProps): import("react").JSX.Element;

package/dist/features/media/upload/MediaUploadList.js

@@ -6,6 +6,7 @@ import { MediaImage } from "../MediaImage";
 import { MediaVideo } from "../MediaVideo";
 import { inferMediaTypeFromMime } from "../types/index";
 import { normalizeError } from "../../../errors/normalize";
+import { toUserMessage } from "../../../errors/error-display-map";
 const __O = {
     hidden: "overflow-hidden",
 };
@@ -20,7 +21,7 @@ function fileNameFromUrl(url) {
         return url;
     }
 }
-export function MediaUploadList({ label, value, onChange, onUpload, accept = "image/*,video/*,application/pdf", maxSizeMB = 50, maxItems = 12, disabled = false, helperText, onAbort, onStagedUrlsChange, isPersisted = false, }) {
+export function MediaUploadList({ label, value, onChange, onUpload, accept = "image/*,video/*,application/pdf", maxSizeMB = 50, maxItems = 12, maxImages, maxVideos, disabled = false, helperText, onAbort, onStagedUrlsChange, isPersisted = false, }) {
     const inputRef = useRef(null);
     const [isLoading, setIsLoading] = useState(false);
     const [error, setError] = useState(null);
@@ -69,15 +70,51 @@ export function MediaUploadList({ label, value, onChange, onUpload, accept = "im
             e.currentTarget.value = "";
             return;
         }
+        /*
+         * Per-type ceilings. Counted from the INCOMING batch as well as what is
+         * already there, so selecting five videos at once is refused up front
+         * rather than after four of them have uploaded.
+         *
+         * `inferMediaTypeFromMime` is the same classifier used to tag the item
+         * below, so the count and the stored `type` can never disagree.
+         */
+        if (maxImages != null || maxVideos != null) {
+            const incoming = files.map((f) => inferMediaTypeFromMime(f.type, f.name));
+            const countOf = (t) => value.filter((v) => v.type === t).length + incoming.filter((v) => v === t).length;
+            if (maxImages != null && countOf("image") > maxImages) {
+                setError(`You can upload up to ${maxImages} image${maxImages === 1 ? "" : "s"}.`);
+                e.currentTarget.value = "";
+                return;
+            }
+            if (maxVideos != null && countOf("video") > maxVideos) {
+                setError(maxVideos === 1
+                    ? "Only one video is allowed. Remove the current one to replace it."
+                    : `You can upload up to ${maxVideos} videos.`);
+                e.currentTarget.value = "";
+                return;
+            }
+        }
         setError(null);
+        /*
+         * Size is checked BEFORE the upload loop, and reported directly rather
+         * than thrown.
+         *
+         * It used to throw into the shared catch, which then rendered
+         * `err.message` — so one branch of that catch was authored copy worth
+         * showing while the other was whatever the network layer happened to
+         * throw. Splitting them lets the useful message survive and the arbitrary
+         * one resolve through `toUserMessage` (Rule #9.6 / Root Cause #86).
+         */
+        const tooBig = files.find((f) => f.size / 1024 / 1024 > maxSizeMB);
+        if (tooBig) {
+            setError(`${tooBig.name} exceeds ${maxSizeMB}MB`);
+            e.currentTarget.value = "";
+            return;
+        }
         setIsLoading(true);
         try {
             const uploaded = [];
             for (const file of files) {
-                const sizeMb = file.size / 1024 / 1024;
-                if (sizeMb > maxSizeMB) {
-                    throw new Error(`${file.name} exceeds ${maxSizeMB}MB`);
-                }
                 const url = await onUpload(file);
                 stageUrl(url);
                 uploaded.push({
@@ -88,8 +125,12 @@ export function MediaUploadList({ label, value, onChange, onUpload, accept = "im
             onChange([...value, ...uploaded]);
         }
         catch (err) {
-            void normalizeError(err);
-            setError(err instanceof Error ? err.message : "Upload failed");
+            const normalized = normalizeError(err);
+            // Never the thrown value's own text: `onUpload` reaches the signed-URL
+            // endpoint, so this is where a server sentence would surface.
+            setError(toUserMessage(normalized.code, undefined, {
+                fallback: "Upload failed. Please try again.",
+            }));
         }
         finally {
             setIsLoading(false);
@@ -107,5 +148,14 @@ export function MediaUploadList({ label, value, onChange, onUpload, accept = "im
             unstageUrl(target.url);
         }
     };
-    return (_jsxs(Stack, { gap: "sm", children: [_jsx(Label, { className: "block", color: "muted", size: "sm", weight: "medium", children: label }), value.length > 0 && (_jsx(Div, { layout: "grid", gap: "3", className: "grid-cols-1 sm:grid-cols-2", children: value.map((item, index) => (_jsxs(Div, { rounded: "lg", padding: "sm", border: "default", surface: "muted", children: [item.type === "video" ? (_jsx(Div, { className: `relative aspect-square max-h-24 ${__O.hidden}`, rounded: "lg", children: _jsx(MediaVideo, { src: item.url, alt: item.alt || `Media ${index + 1}`, controls: true }) })) : item.type === "image" ? (_jsx(Div, { className: `relative aspect-square max-h-24 ${__O.hidden}`, rounded: "lg", children: _jsx(MediaImage, { src: item.url, alt: item.alt || `Media ${index + 1}`, size: "card", objectFit: "contain" }) })) : (_jsx(Anchor, { href: item.url, tone: "none", underline: "none", className: CLS_PDF_LINK, children: fileNameFromUrl(item.url) })), !disabled && (_jsx(Div, { className: "mt-2", children: _jsx(Button, { type: "button", size: "sm", variant: "danger", onClick: () => removeAt(index), children: "Remove" }) }))] }, `${item.url}-${index}`))) })), !disabled && value.length < maxItems && (_jsx(Button, { type: "button", variant: "outline", size: "sm", onClick: () => inputRef.current?.click(), disabled: isLoading, children: isLoading ? "Uploading..." : `+ Add Files (${value.length}/${maxItems})` })), isLoading && (_jsxs(Row, { align: "center", gap: "sm", children: [_jsx(Spinner, { size: "sm" }), _jsx(Text, { size: "sm", variant: "secondary", children: "Uploading" })] })), _jsx("input", { ref: inputRef, type: "file", multiple: true, accept: accept, onChange: handleFileChange, className: "hidden", "aria-hidden": "true", "data-testid": "media-upload-list-input" }), helperText && !error && (_jsx(Text, { variant: "secondary", size: "xs", children: helperText })), error && _jsx(Alert, { variant: "error", children: error })] }));
+    return (_jsxs(Stack, { gap: "sm", children: [_jsx(Label, { className: "block", color: "muted", size: "sm", weight: "medium", children: label }), value.length > 0 && (_jsx(Div, { layout: "grid", gap: "3", className: "grid-cols-1 sm:grid-cols-2", children: value.map((item, index) => (_jsxs(Div, { rounded: "lg", padding: "sm", border: "default", surface: "muted", children: [item.type === "video" ? (_jsx(Div, { className: `relative aspect-square max-h-24 ${__O.hidden}`, rounded: "lg", children: _jsx(MediaVideo, { src: item.url, alt: item.alt || `Media ${index + 1}`, controls: true }) })) : item.type === "image" ? (_jsx(Div, { className: `relative aspect-square max-h-24 ${__O.hidden}`, rounded: "lg", children: _jsx(MediaImage, { src: item.url, alt: item.alt || `Media ${index + 1}`, size: "card", objectFit: "contain" }) })) : (_jsx(Anchor, { href: item.url, tone: "none", underline: "none", className: CLS_PDF_LINK, children: fileNameFromUrl(item.url) })), !disabled && (_jsx(Div, { className: "mt-2", children: _jsx(Button, { type: "button", size: "sm", variant: "danger", onClick: () => removeAt(index), children: "Remove" }) }))] }, `${item.url}-${index}`))) })), !disabled && value.length < maxItems && (_jsx(Button, { type: "button", variant: "outline", size: "sm", onClick: () => inputRef.current?.click(), disabled: isLoading, children: isLoading ? "Uploading..." : `+ Add Files (${value.length}/${maxItems})` })), isLoading && (_jsxs(Row, { align: "center", gap: "sm", children: [_jsx(Spinner, { size: "sm" }), _jsx(Text, { size: "sm", variant: "secondary", children: "Uploading" })] })), _jsx("input", { ref: inputRef, type: "file", multiple: true, accept: accept, onChange: handleFileChange, className: "hidden", "aria-hidden": "true", "data-testid": "media-upload-list-input" }), (maxImages != null || maxVideos != null) && (_jsx(Text, { variant: "secondary", size: "xs", children: [
+                    maxImages != null
+                        ? `${value.filter((v) => v.type === "image").length}/${maxImages} images`
+                        : null,
+                    maxVideos != null
+                        ? `${value.filter((v) => v.type === "video").length}/${maxVideos} video${maxVideos === 1 ? "" : "s"}`
+                        : null,
+                ]
+                    .filter(Boolean)
+                    .join(" · ") })), helperText && !error && (_jsx(Text, { variant: "secondary", size: "xs", children: helperText })), error && _jsx(Alert, { variant: "error", children: error })] }));
 }

package/dist/features/orders/components/RefundRequestView.d.ts

@@ -1,19 +1,35 @@
 /**
- * RefundRequestView — buyer-facing refund submission form.
+ * RefundRequestView — buyer-facing return / refund request form.
  *
- * Shows 3 acknowledgment checkboxes (via the appkit Checkbox primitive) that
- * the buyer must tick before the submit button becomes active. On submit the
- * parent's `onSubmitRequest` is called with the reason string; the parent
- * (page or modal) is responsible for calling the API.
+ * ## What changed and why
  *
- * This component is presentational: it has no server-action imports and
- * does not talk to the API directly.
+ * This component had **zero call sites** and was grandfathered in
+ * `audit-orphan-view-component`. It also predated three project rules:
+ * it hand-rolled `useState<string | null>` for its error (Rule #9.4), took a
+ * free-text reason with no schema (Rule #9.2), and had no `<FormErrorSummary>`.
+ *
+ * The free-text reason is the substantive change. "Final sale, unless the
+ * buyer didn't get what they paid for" cannot be enforced against prose — the
+ * server needs a coded reason to decide, so the buyer picks one here and the
+ * note is the optional elaboration beside it.
+ *
+ * ## Final sale is a filter, not a wall
+ *
+ * When a line in scope is final sale, this does NOT refuse to render. It says
+ * so, and narrows the picker to the reasons that remain valid. Blocking the
+ * page outright would hide the two claims a final sale can never refuse —
+ * which are exactly the ones a buyer in trouble needs.
  */
 import React from "react";
-import type { OrderDocument } from "../schemas";
+import { type ReturnReason } from "../../../_internal/shared/features/orders/return-reasons";
+import type { Order } from "../types";
+export interface RefundRequestSubmission {
+    reasonCode: ReturnReason;
+    reasonNote?: string;
+}
 export interface RefundRequestViewProps {
-    order: Pick<OrderDocument, "id" | "totalPrice" | "currency" | "isNonRefundable" | "refunds" | "contestable">;
-    onSubmitRequest: (reason: string) => Promise<void>;
+    order: Pick<Order, "id" | "total" | "currency" | "isNonRefundable" | "contestable" | "items">;
+    onSubmitRequest: (submission: RefundRequestSubmission) => Promise<void>;
     isLoading?: boolean;
     className?: string;
 }

package/dist/features/orders/components/RefundRequestView.js

@@ -1,48 +1,132 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 /**
- * RefundRequestView — buyer-facing refund submission form.
+ * RefundRequestView — buyer-facing return / refund request form.
  *
- * Shows 3 acknowledgment checkboxes (via the appkit Checkbox primitive) that
- * the buyer must tick before the submit button becomes active. On submit the
- * parent's `onSubmitRequest` is called with the reason string; the parent
- * (page or modal) is responsible for calling the API.
+ * ## What changed and why
  *
- * This component is presentational: it has no server-action imports and
- * does not talk to the API directly.
+ * This component had **zero call sites** and was grandfathered in
+ * `audit-orphan-view-component`. It also predated three project rules:
+ * it hand-rolled `useState<string | null>` for its error (Rule #9.4), took a
+ * free-text reason with no schema (Rule #9.2), and had no `<FormErrorSummary>`.
+ *
+ * The free-text reason is the substantive change. "Final sale, unless the
+ * buyer didn't get what they paid for" cannot be enforced against prose — the
+ * server needs a coded reason to decide, so the buyer picks one here and the
+ * note is the optional elaboration beside it.
+ *
+ * ## Final sale is a filter, not a wall
+ *
+ * When a line in scope is final sale, this does NOT refuse to render. It says
+ * so, and narrows the picker to the reasons that remain valid. Blocking the
+ * page outright would hide the two claims a final sale can never refuse —
+ * which are exactly the ones a buyer in trouble needs.
  */
-import { useState } from "react";
-import { Button, Checkbox, Div, Span, Stack, Text, Textarea } from "../../../ui";
+import { useMemo, useState } from "react";
+import { Alert, Div, Span, Stack, Text, Checkbox, PaginatedSelect } from "../../../ui";
+import { FormShellContext, useFormShellState, FormErrorSummary, FieldTextarea, } from "../../../ui/forms";
+import { SectionForm, useSectionFormNav } from "../../shell";
+import { z } from "zod";
 import { REFUND_COPY } from "../../../_internal/shared/features/orders/refund-copy";
+import { RETURN_REASON_LABEL, selectableReturnReasons, } from "../../../_internal/shared/features/orders/return-reasons";
 import { formatCurrency } from "../../../utils/number.formatter";
 import { normalizeError } from "../../../errors/normalize";
 import { toUserMessage } from "../../../errors/error-display-map";
 const ACK_COUNT = REFUND_COPY.request.acknowledgments.length;
-const CLS_WARN_PANEL = "rounded-xl border border-warning bg-warning-surface p-[var(--appkit-space-4)] dark:border-warning";
 export function RefundRequestView({ order, onSubmitRequest, isLoading = false, className = "", }) {
-    const [acknowledged, setAcknowledged] = useState(Array(ACK_COUNT).fill(false));
-    const [reason, setReason] = useState("");
-    const [error, setError] = useState(null);
-    const allChecked = acknowledged.every(Boolean);
-    const canSubmit = allChecked && reason.trim().length >= 10 && !isLoading;
+    /*
+     * Does anything in this order carry the final-sale term? Read from the
+     * ORDER's own per-line snapshot — the product may have been re-listed on
+     * different terms since, and the buyer agreed to the terms at checkout.
+     */
+    const hasFinalSaleLine = useMemo(() => (order.items ?? []).some((i) => i.finalSale === true), [order.items]);
+    const allowedReasons = useMemo(() => selectableReturnReasons(hasFinalSaleLine), [hasFinalSaleLine]);
+    /*
+     * The schema mirrors the server's `returnRequestSchema`, plus the
+     * acknowledgements, which are a client-side consent gate and are not stored.
+     * `reasonCode` is constrained to the ALLOWED set rather than the full enum,
+     * so a change-of-mind reason cannot be submitted on a final-sale order even
+     * if the option list were bypassed.
+     */
+    const schema = useMemo(() => z.object({
+        reasonCode: z.enum(allowedReasons, {
+            errorMap: () => ({ message: "Choose why you're returning this order." }),
+        }),
+        reasonNote: z.string().max(500).optional(),
+        acknowledged: z
+            .array(z.boolean())
+            .refine((a) => a.every(Boolean), {
+            message: "Please acknowledge all three statements before submitting.",
+        }),
+    }), [allowedReasons]);
+    const [draft, setDraft] = useState({
+        reasonCode: "",
+        reasonNote: "",
+        acknowledged: Array(ACK_COUNT).fill(false),
+    });
+    const update = (partial) => setDraft((prev) => ({ ...prev, ...partial }));
+    const sections = useMemo(() => [
+        {
+            id: "declare",
+            label: "Why are you returning this?",
+            required: true,
+            fields: ["reasonCode", "reasonNote"],
+            render: ({ values, onChange }) => (_jsxs(Stack, { gap: "md", children: [_jsxs(Text, { size: "sm", color: "muted", children: [REFUND_COPY.request.orderTotalLabel, " ", _jsx(Span, { weight: "bold", children: formatCurrency(order.total, order.currency ?? "INR") })] }), hasFinalSaleLine && (_jsx(Alert, { variant: "warning", title: REFUND_COPY.request.finalSaleNoticeHeading, children: "You can\u2019t return it for a change of mind, but you can still claim if it never arrived, arrived damaged, was the wrong item, wasn\u2019t as described, or is counterfeit. Only those reasons are listed below." })), _jsxs(Stack, { gap: "xs", children: [_jsxs(Text, { size: "sm", weight: "semibold", children: [REFUND_COPY.request.reasonSelectLabel, " ", _jsx(Span, { "aria-hidden": true, children: "*" })] }), _jsx(PaginatedSelect, { value: values.reasonCode === "" ? null : values.reasonCode, onChange: (v) => onChange({ reasonCode: v ?? "" }), options: allowedReasons.map((r) => ({
+                                    value: r,
+                                    label: RETURN_REASON_LABEL[r],
+                                })), placeholder: REFUND_COPY.request.reasonSelectPlaceholder, ariaLabel: REFUND_COPY.request.reasonSelectLabel })] }), _jsx(FieldTextarea, { name: "reasonNote", label: REFUND_COPY.request.reasonNoteLabel, value: values.reasonNote, onChange: (v) => onChange({ reasonNote: v }), rows: 3, maxLength: 500, showCharCount: true })] })),
+        },
+        {
+            id: "declare-acknowledgements",
+            label: REFUND_COPY.request.acknowledgeHeading,
+            required: true,
+            fields: ["acknowledged"],
+            render: ({ values, onChange }) => (_jsx(Stack, { gap: "sm", children: REFUND_COPY.request.acknowledgments.map((text, i) => (_jsx(Checkbox, { checked: values.acknowledged[i] ?? false, onChange: () => onChange({
+                        acknowledged: values.acknowledged.map((v, idx) => idx === i ? !v : v),
+                    }), label: _jsx(Text, { size: "sm", className: "leading-snug", children: text }), "aria-label": `Acknowledgment ${i + 1}` }, i))) })),
+        },
+    ], [order.total, order.currency, hasFinalSaleLine, allowedReasons]);
+    const nav = useSectionFormNav(sections, draft);
+    const { shellCtx, setFieldError, clearErrors } = useFormShellState(schema, {
+        sections: nav.sectionMeta,
+        onGoToSection: nav.goToSection,
+        fieldToSectionIndex: nav.fieldToSectionIndex,
+    });
+    // ── Early returns: states in which no request can be made at all ──────────
     if (order.isNonRefundable) {
-        return (_jsx(Div, { className: `${className}`, rounded: "xl", padding: "md", surface: "muted", border: "default", children: _jsx(Text, { size: "sm", color: "muted", children: REFUND_COPY.request.nonRefundableMessage }) }));
+        return (_jsx(Div, { className: className, rounded: "xl", padding: "md", surface: "muted", border: "default", children: _jsx(Text, { size: "sm", color: "muted", children: REFUND_COPY.request.nonRefundableMessage }) }));
     }
     if (order.contestable === false) {
-        return (_jsx(Div, { className: `${CLS_WARN_PANEL} ${className}`, children: _jsx(Text, { size: "sm", className: "text-warning", children: REFUND_COPY.request.alreadyRefundedMessage }) }));
+        return (_jsx(Alert, { variant: "warning", className: className, children: REFUND_COPY.request.alreadyRefundedMessage }));
     }
-    const handleToggle = (i) => setAcknowledged((prev) => prev.map((v, idx) => (idx === i ? !v : v)));
     const handleSubmit = async () => {
-        setError(null);
+        clearErrors();
+        const parsed = schema.safeParse(draft);
+        if (!parsed.success) {
+            for (const issue of parsed.error.issues) {
+                setFieldError(issue.path.map(String).join("."), issue.message);
+            }
+            return;
+        }
         try {
-            await onSubmitRequest(reason.trim());
+            await onSubmitRequest({
+                reasonCode: parsed.data.reasonCode,
+                ...(parsed.data.reasonNote?.trim()
+                    ? { reasonNote: parsed.data.reasonNote.trim() }
+                    : {}),
+            });
         }
         catch (err) {
             const e = normalizeError(err);
-            setError(toUserMessage(e.code, undefined, {
-                fallback: REFUND_COPY.request.errorFallback,
-            }));
+            /*
+             * Surfaced on the field the server actually rejected. A final-sale
+             * refusal is always about the chosen reason, so putting it on
+             * `reasonCode` puts the message next to the control that fixes it.
+             *
+             * `toUserMessage` and never the raw server text — Rule #9.6.
+             */
+            setFieldError("reasonCode", toUserMessage(e.code, undefined, { fallback: REFUND_COPY.request.errorFallback }));
         }
     };
-    return (_jsxs(Stack, { gap: "md", className: className, children: [_jsxs(Text, { size: "sm", color: "muted", children: [REFUND_COPY.request.orderTotalLabel, " ", _jsx(Span, { weight: "bold", children: formatCurrency(order.totalPrice, order.currency ?? "INR") })] }), _jsxs(Stack, { gap: "xs", children: [_jsxs(Text, { size: "sm", weight: "semibold", children: [REFUND_COPY.request.reasonLabel, " ", _jsx(Span, { "aria-hidden": true, children: "*" })] }), _jsx(Textarea, { value: reason, onChange: (e) => setReason(e.target.value), placeholder: REFUND_COPY.request.reasonPlaceholder, rows: 3, "aria-required": "true", "aria-label": REFUND_COPY.request.reasonLabel })] }), _jsxs(Stack, { gap: "sm", children: [_jsx(Text, { size: "sm", weight: "semibold", children: REFUND_COPY.request.acknowledgeHeading }), REFUND_COPY.request.acknowledgments.map((text, i) => (_jsx(Checkbox, { checked: acknowledged[i], onChange: () => handleToggle(i), label: _jsx(Text, { size: "sm", className: "leading-snug", children: text }), "aria-label": `Acknowledgment ${i + 1}` }, i)))] }), error && (_jsx(Text, { size: "sm", color: "danger", role: "alert", children: error })), _jsx(Button, { variant: "danger", onClick: handleSubmit, disabled: !canSubmit, "aria-busy": isLoading, children: isLoading ? REFUND_COPY.request.submittingLabel : REFUND_COPY.request.submitLabel })] }));
+    return (_jsx(FormShellContext.Provider, { value: shellCtx, children: _jsxs(Stack, { gap: "md", className: className, children: [_jsx(FormErrorSummary, {}), _jsx(SectionForm, { sections: sections, values: draft, onChange: update, onSubmit: handleSubmit, schema: schema, openIds: nav.openIds, onOpenChange: nav.setOpenIds, submitLabel: REFUND_COPY.request.submitLabel, isLoading: isLoading })] }) }));
 }

package/dist/features/orders/schemas/firestore.d.ts

@@ -6,6 +6,7 @@ import type { OrderType } from "../utils/order-splitter";
 import type { BaseDocument } from "../../../_internal/shared/types/base-document";
 import type { ListingType } from "../../products/types";
 import type { StatusChangeEntry } from "../../../_internal/shared/history/index";
+import type { ReturnReason } from "../../../_internal/shared/features/orders/return-reasons";
 export interface OrderSourceStandard {
     path: "standard";
     listPrice: number;
@@ -203,6 +204,20 @@ export interface OrderDocumentItem {
     /** P-8 GST — snapshotted from the product at order time so the invoice stays accurate even if the product's HSN/rate later changes. */
     hsnCode?: string;
     gstRate?: 0 | 5 | 12 | 18 | 28;
+    /**
+     * Whether THIS line was final sale at the moment of purchase.
+     *
+     * Snapshotted, exactly like `gstRate` and `hsnCode` above and for the same
+     * reason: it is a term the buyer agreed to at checkout. Re-reading
+     * `product.finalSale` at refund time would let a seller flip the switch
+     * after the sale and retroactively refuse a return the buyer was promised —
+     * or, in the other direction, lose a restriction the buyer accepted.
+     *
+     * ALWAYS an explicit boolean here, resolved through `isFinalSale()` by the
+     * order-row builder, so no downstream reader has to know that absence means
+     * true on the product. Absence HERE means the order predates the field.
+     */
+    finalSale?: boolean;
 }
 /**
  * One refund event on an order. Multiple partial refund events are allowed
@@ -217,7 +232,17 @@ export interface OrderRefundEvent {
     amount: number;
     /** ProductIds / itemIds that were refunded (for partial refunds). */
     itemIds?: string[];
+    /**
+     * Human-readable reason, rendered by `RefundHistoryTable`. Derived from
+     * `reasonCode` (plus any buyer note) rather than typed freehand, so the
+     * prose and the code can never disagree about why a refund happened.
+     */
     reason: string;
+    /**
+     * Coded reason. Optional only because refunds recorded before the enum
+     * existed have none — every new refund sets it.
+     */
+    reasonCode?: ReturnReason;
     refundedAt: Date;
     refundedBy: string;
     /** Set when Razorpay processed the refund. */
@@ -280,6 +305,23 @@ export interface OrderDocument extends BaseDocument {
     deliveryDate?: Date;
     cancellationDate?: Date;
     cancellationReason?: string;
+    /**
+     * Why the buyer asked to return this order. Closed enum — see
+     * `_internal/shared/features/orders/return-reasons`.
+     *
+     * `requestReturnAction` accepted a free-text reason and then discarded it
+     * before writing, so until now an order could reach `return_requested` with
+     * no recorded reason at all and the seller had nothing to act on.
+     */
+    returnReasonCode?: ReturnReason;
+    /** Optional buyer elaboration alongside the coded reason. */
+    returnReasonNote?: string;
+    returnRequestedAt?: Date;
+    /**
+     * Which lines the buyer wants to return. Absent means the whole order —
+     * the same convention `processRefundAction`'s `itemIds` already uses.
+     */
+    returnRequestedItemIds?: string[];
     refundAmount?: number;
     refundStatus?: RefundStatus;
     refundFeeDeducted?: number;

package/dist/features/orders/types/index.d.ts

@@ -46,6 +46,15 @@ export interface OrderItem {
     bundleCategorySlug?: string;
     /** Snapshot of bundle.bundleProductIds at order-creation time. */
     bundleProductIds?: string[];
+    /**
+     * Whether this line was final sale when it was bought. Snapshotted on the
+     * order document; surfaced here so the buyer's return form can narrow the
+     * reason list without a second fetch.
+     *
+     * Absent means the order predates the field — NOT "returnable". The server
+     * gate reads the document, so this is a rendering hint only.
+     */
+    finalSale?: boolean;
 }
 /**
  * One entry on an order's timeline — the client-facing shape of
@@ -106,6 +115,21 @@ export interface Order {
     couponDiscount?: number;
     /** Every discount applied to this order — the full stack, not just the first. */
     appliedDiscounts?: AppliedOrderDiscount[];
+    /**
+     * Listing-TYPE level block (prize-draw entries). Distinct from per-line
+     * `finalSale`: this refuses every reason, that one refuses only
+     * change-of-mind reasons.
+     */
+    isNonRefundable?: boolean;
+    /**
+     * False once a refund has been posted — no further dispute or RMA.
+     * Was never mapped, so the buyer-facing refund form could not render its
+     * "already refunded" state at all.
+     */
+    contestable?: boolean;
+    /** Coded reason recorded when the buyer requested a return. */
+    returnReasonCode?: string;
+    returnReasonNote?: string;
     /**
      * Paid add-ons the buyer opted into for THIS order (= this store).
      *

package/dist/features/pre-orders/components/PreOrderDetailPageView.js

@@ -25,6 +25,7 @@ import { CustomSectionTabContent } from "../../products/components/CustomSection
 import { PreOrderActionsClient } from "./PreOrderActionsClient";
 import { ProductGalleryClient } from "../../products/components/ProductGalleryClient";
 import { ProductFeatureBadges } from "../../products/components/ProductFeatureBadges";
+import { isFinalSale } from "../../products/constants/final-sale";
 import { FeatureBadgeList } from "../../products/components/FeatureBadge";
 import { ShareButton } from "../../products/components/ShareButton";
 import { SublistingCarouselSection } from "../../products/components/SublistingCarouselSection";
@@ -45,8 +46,8 @@ const PRODUCTION_STATUS_LABELS = {
     in_production: "In Production",
     ready_to_ship: "Ready to Ship",
 };
-function PreOrderInfoSection({ title, productionStatus, maxPerUser, deliveryDate, featured, freeShipping, condition, isCancellable, category, categoryName, brand, brandSlug, productFeatures, features, descriptionHtml, safeSeller, storeHref, }) {
-    return (_jsxs(Stack, { gap: "md", children: [_jsxs(Div, { children: [_jsxs(Row, { gap: "xs", wrap: true, className: "mb-2", children: [_jsx(Span, { size: "xs", weight: "semibold", className: CLS_PREORDER_BADGE, children: "Pre-Order" }), productionStatus && (_jsx(Span, { size: "xs", weight: "medium", className: "inline-block", padding: "pill-sm", rounded: "full", surface: "subtle", color: "muted", children: PRODUCTION_STATUS_LABELS[productionStatus] ?? productionStatus })), maxPerUser !== null && (_jsxs(Span, { size: "xs", weight: "medium", className: CLS_STATUS_BADGE, children: ["Limit: ", maxPerUser, " per customer"] }))] }), _jsx(Heading, { level: 1, className: "leading-snug", smSize: "2xl", color: "primary", size: "xl", weight: "bold", children: title })] }), deliveryDate && (_jsxs(Row, { color: "muted", textSize: "sm", align: "center", gap: "xs", children: [_jsx(Span, { children: "\uD83D\uDCC5" }), _jsx(Span, { children: "Estimated delivery:" }), _jsx(Span, { weight: "medium", children: deliveryDate.toLocaleDateString(undefined, { year: "numeric", month: "long" }) })] })), _jsx(ProductFeatureBadges, { featured: featured, freeShipping: freeShipping, condition: condition ?? undefined, returnable: isCancellable, labels: {
+function PreOrderInfoSection({ title, productionStatus, maxPerUser, deliveryDate, featured, freeShipping, condition, isCancellable, finalSale, category, categoryName, brand, brandSlug, productFeatures, features, descriptionHtml, safeSeller, storeHref, }) {
+    return (_jsxs(Stack, { gap: "md", children: [_jsxs(Div, { children: [_jsxs(Row, { gap: "xs", wrap: true, className: "mb-2", children: [_jsx(Span, { size: "xs", weight: "semibold", className: CLS_PREORDER_BADGE, children: "Pre-Order" }), productionStatus && (_jsx(Span, { size: "xs", weight: "medium", className: "inline-block", padding: "pill-sm", rounded: "full", surface: "subtle", color: "muted", children: PRODUCTION_STATUS_LABELS[productionStatus] ?? productionStatus })), maxPerUser !== null && (_jsxs(Span, { size: "xs", weight: "medium", className: CLS_STATUS_BADGE, children: ["Limit: ", maxPerUser, " per customer"] }))] }), _jsx(Heading, { level: 1, className: "leading-snug", smSize: "2xl", color: "primary", size: "xl", weight: "bold", children: title })] }), deliveryDate && (_jsxs(Row, { color: "muted", textSize: "sm", align: "center", gap: "xs", children: [_jsx(Span, { children: "\uD83D\uDCC5" }), _jsx(Span, { children: "Estimated delivery:" }), _jsx(Span, { weight: "medium", children: deliveryDate.toLocaleDateString(undefined, { year: "numeric", month: "long" }) })] })), _jsx(ProductFeatureBadges, { featured: featured, freeShipping: freeShipping, condition: condition ?? undefined, returnable: isCancellable, finalSale: finalSale, labels: {
                     featured: "Featured",
                     fasterDelivery: "Faster Delivery",
                     ratedSeller: "Rated Seller",
@@ -56,6 +57,7 @@ function PreOrderInfoSection({ title, productionStatus, maxPerUser, deliveryDate
                     conditionBroken: "For Parts",
                     conditionRefurbished: "Refurbished",
                     returnable: "Cancellable",
+                    finalSale: "Final Sale",
                     freeShipping: "Free Shipping",
                     codAvailable: "Cash on Delivery",
                     emiAvailable: "EMI Available",
@@ -162,7 +164,7 @@ export async function PreOrderDetailPageView({ id, initialPreOrder, onReserveNow
                     price: typeof p.price === "number" ? p.price : undefined,
                     storeId: typeof p.storeId === "string" ? p.storeId : undefined,
                     storeName: typeof p.storeName === "string" ? p.storeName : undefined,
-                } }), _jsxs(Container, { size: "xl", padding: "y-lg", children: [_jsxs(Row, { className: "mb-4", align: "center", justify: "between", gap: "sm", wrap: true, children: [_jsxs(Nav, { "aria-label": "Breadcrumb", layout: "flex-wrap", gap: "2xs", textSize: "xs", color: "muted", children: [_jsx(Link, { href: String(ROUTES.HOME), className: CLS_BREADCRUMB_LINK, children: "Home" }), _jsx(Span, { "aria-hidden": true, children: "/" }), _jsx(Link, { href: String(ROUTES.PUBLIC.PRE_ORDERS), className: CLS_BREADCRUMB_LINK, children: "Pre-Orders" }), category && (_jsxs(_Fragment, { children: [_jsx(Span, { "aria-hidden": true, children: "/" }), _jsx(Link, { href: String(ROUTES.PUBLIC.CATEGORY_DETAIL(category)), className: CLS_BREADCRUMB_LINK, children: categoryName || category })] })), _jsx(Span, { "aria-hidden": true, children: "/" }), _jsx(Span, { className: "truncate max-w-[200px]", color: "muted", children: title })] }), _jsx(ShareButton, { title: title })] }), _jsx(PreOrderDetailView, { renderGallery: () => (_jsx(ProductGalleryClient, { images: images, video: productVideo, productName: title })), renderInfo: () => (_jsx(PreOrderInfoSection, { title: title, productionStatus: productionStatus, maxPerUser: maxPerUser, deliveryDate: deliveryDate, featured: featured, freeShipping: freeShipping, condition: condition, isCancellable: isCancellable, category: category, categoryName: categoryName, brand: brand, brandSlug: brandSlug, productFeatures: productFeatures, features: features, descriptionHtml: descriptionHtml, safeSeller: safeSeller, storeHref: storeHref })), renderSublistingSection: sublistingCategoryId
+                } }), _jsxs(Container, { size: "xl", padding: "y-lg", children: [_jsxs(Row, { className: "mb-4", align: "center", justify: "between", gap: "sm", wrap: true, children: [_jsxs(Nav, { "aria-label": "Breadcrumb", layout: "flex-wrap", gap: "2xs", textSize: "xs", color: "muted", children: [_jsx(Link, { href: String(ROUTES.HOME), className: CLS_BREADCRUMB_LINK, children: "Home" }), _jsx(Span, { "aria-hidden": true, children: "/" }), _jsx(Link, { href: String(ROUTES.PUBLIC.PRE_ORDERS), className: CLS_BREADCRUMB_LINK, children: "Pre-Orders" }), category && (_jsxs(_Fragment, { children: [_jsx(Span, { "aria-hidden": true, children: "/" }), _jsx(Link, { href: String(ROUTES.PUBLIC.CATEGORY_DETAIL(category)), className: CLS_BREADCRUMB_LINK, children: categoryName || category })] })), _jsx(Span, { "aria-hidden": true, children: "/" }), _jsx(Span, { className: "truncate max-w-[200px]", color: "muted", children: title })] }), _jsx(ShareButton, { title: title })] }), _jsx(PreOrderDetailView, { renderGallery: () => (_jsx(ProductGalleryClient, { images: images, video: productVideo, productName: title })), renderInfo: () => (_jsx(PreOrderInfoSection, { title: title, productionStatus: productionStatus, maxPerUser: maxPerUser, deliveryDate: deliveryDate, featured: featured, freeShipping: freeShipping, condition: condition, isCancellable: isCancellable, finalSale: isFinalSale(p), category: category, categoryName: categoryName, brand: brand, brandSlug: brandSlug, productFeatures: productFeatures, features: features, descriptionHtml: descriptionHtml, safeSeller: safeSeller, storeHref: storeHref })), renderSublistingSection: sublistingCategoryId
                             ? () => (_jsx(SublistingCarouselSection, { sublistingCategoryId: sublistingCategoryId, currentListingId: String(product.id) }))
                             : undefined, renderGroupSection: groupId
                             ? () => (_jsx(ShowGroupSection, { groupId: groupId, currentSlug: String(p.slug ?? product.id), isParent: isGroupParent, groupTitle: groupTitle }))

package/dist/features/products/components/ProductDetailPageView.js

@@ -14,6 +14,8 @@ const CLS_STOCK_IN = "bg-success-surface text-success dark:bg-success-surface da
 const CLS_STOCK_OUT = "bg-error-surface text-error dark:bg-error-surface dark:text-error";
 const CLS_BUNDLE_PILL = "inline-flex items-center gap-[var(--appkit-space-1)] rounded-full border border-success bg-success-surface px-[var(--appkit-space-2-5)] py-[var(--appkit-space-1)] text-[length:var(--appkit-text-xs)] font-semibold text-success transition-colors hover:border-success hover:bg-success-surface dark:border-success/60 dark:bg-success-surface dark:text-success dark:hover:border-success dark:hover:bg-success-surface";
 const CLS_FREE_SHIPPING_ICON = "mt-0.5 flex-shrink-0 text-success";
+/** Leading icon in a Delivery & Returns row. */
+const CLS_POLICY_ROW_ICON = "mt-0.5 flex-shrink-0";
 const CLS_BUNDLE_BOX = "rounded-xl border border-success dark:border-success/60 bg-success-surface dark:bg-success-surface p-[var(--appkit-space-5)]";
 const CLS_BUNDLE_ICON = "text-success dark:text-success";
 const CLS_BUNDLE_TITLE = "text-[length:var(--appkit-text-sm)] font-semibold text-success dark:text-success";
@@ -30,6 +32,7 @@ import { ProductDetailView } from "./ProductDetailView";
 import { ProductGalleryClient } from "./ProductGalleryClient";
 import { ProductTabsShell } from "./ProductTabsShell";
 import { ProductFeatureBadges } from "./ProductFeatureBadges";
+import { isFinalSale } from "../constants/final-sale";
 import { FeatureBadgeList } from "./FeatureBadge";
 import { ShareButton } from "./ShareButton";
 import { CustomSectionTabContent } from "./CustomSectionTabContent";
@@ -163,6 +166,12 @@ export async function ProductDetailPageView({ slug, initialProduct, renderOfferA
         : DEFAULT_MIN_OFFER_PERCENT;
     const shippingInfo = typeof p.shippingInfo === "string" ? p.shippingInfo : null;
     const returnPolicy = typeof p.returnPolicy === "string" ? p.returnPolicy : null;
+    /*
+     * Absent means final sale, so this must go through `isFinalSale` — reading
+     * `p.finalSale` directly would treat every listing created before the field
+     * existed as returnable.
+     */
+    const finalSale = isFinalSale(p);
     const shippingPaidBy = p.shippingPaidBy;
     const freeShipping = shippingPaidBy === "seller";
     const featured = p.featured === true;
@@ -207,7 +216,7 @@ export async function ProductDetailPageView({ slug, initialProduct, renderOfferA
                                                     ? ` — only ${effectiveStock} left`
                                                     : ""] })] })) : (_jsxs(Span, { layout: "inline-flex", gap: "xs", className: `w-fit .5 ${inStock ? CLS_STOCK_IN : CLS_STOCK_OUT}`, rounded: "full", padding: "pill-md", size: "xs", weight: "medium", children: [inStock ? "✓ In Stock" : "✗ Out of Stock", inStock && effectiveStock !== null && effectiveStock <= 10
                                             ? ` — only ${effectiveStock} left`
-                                            : ""] })), (categorySlugs.length > 0 || subcategory || brand) && (_jsxs(Row, { gap: "sm", wrap: true, children: [categorySlugs.map((slug, i) => (_jsx(Link, { href: String(ROUTES.PUBLIC.CATEGORY_DETAIL(slug)), className: "inline-flex items-center rounded-full border border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface)] px-[var(--appkit-space-2-5)] py-[var(--appkit-space-1)] text-[length:var(--appkit-text-xs)] font-medium text-[var(--appkit-color-text-muted)] transition-colors hover:border-primary-300 hover:bg-primary-surface hover:text-primary-700 dark:hover:border-primary-700/60 dark:hover:text-primary-400", children: categoryNames[i] ?? slug }, slug))), subcategory && (_jsx(Span, { layout: "inline-flex", size: "xs", weight: "medium", border: "subtle", rounded: "full", padding: "pill-sm-tall", surface: "muted", color: "muted", transform: "capitalize", children: subcategory })), brand && brandSlug && (_jsx(Link, { href: String(ROUTES.PUBLIC.BRAND_DETAIL(brandSlug)), className: "inline-flex items-center rounded-full border border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface)] px-[var(--appkit-space-2-5)] py-[var(--appkit-space-1)] text-[length:var(--appkit-text-xs)] font-medium text-[var(--appkit-color-text-muted)] transition-colors hover:border-primary-300 hover:bg-primary-surface hover:text-primary-700 dark:hover:border-primary-700/60 dark:hover:text-primary-400", children: brand })), brand && !brandSlug && (_jsx(Span, { layout: "inline-flex", size: "xs", weight: "medium", border: "subtle", rounded: "full", padding: "pill-sm-tall", surface: "muted", color: "muted", children: brand }))] })), bundleMemberships.length > 0 && (_jsx(Row, { gap: "sm", wrap: true, children: bundleMemberships.map((b) => (_jsxs(Link, { href: String(ROUTES.PUBLIC.BUNDLE_DETAIL(b.id)), className: CLS_BUNDLE_PILL, children: [_jsx(Span, { "aria-hidden": "true", children: "\uD83D\uDCE6" }), "In bundle: ", b.title] }, b.id))) })), _jsx(ProductFeatureBadges, { featured: featured, freeShipping: freeShipping, codAvailable: codEnabled === true, codHref: String(ROUTES.PUBLIC.HOW_CHECKOUT_WORKS), emiAvailable: emiEnabled === true, emiHref: String(ROUTES.PUBLIC.HOW_EMI_WORKS), condition: condition ?? undefined, returnable: returnPolicy != null && returnPolicy.length > 0, labels: {
+                                            : ""] })), (categorySlugs.length > 0 || subcategory || brand) && (_jsxs(Row, { gap: "sm", wrap: true, children: [categorySlugs.map((slug, i) => (_jsx(Link, { href: String(ROUTES.PUBLIC.CATEGORY_DETAIL(slug)), className: "inline-flex items-center rounded-full border border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface)] px-[var(--appkit-space-2-5)] py-[var(--appkit-space-1)] text-[length:var(--appkit-text-xs)] font-medium text-[var(--appkit-color-text-muted)] transition-colors hover:border-primary-300 hover:bg-primary-surface hover:text-primary-700 dark:hover:border-primary-700/60 dark:hover:text-primary-400", children: categoryNames[i] ?? slug }, slug))), subcategory && (_jsx(Span, { layout: "inline-flex", size: "xs", weight: "medium", border: "subtle", rounded: "full", padding: "pill-sm-tall", surface: "muted", color: "muted", transform: "capitalize", children: subcategory })), brand && brandSlug && (_jsx(Link, { href: String(ROUTES.PUBLIC.BRAND_DETAIL(brandSlug)), className: "inline-flex items-center rounded-full border border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface)] px-[var(--appkit-space-2-5)] py-[var(--appkit-space-1)] text-[length:var(--appkit-text-xs)] font-medium text-[var(--appkit-color-text-muted)] transition-colors hover:border-primary-300 hover:bg-primary-surface hover:text-primary-700 dark:hover:border-primary-700/60 dark:hover:text-primary-400", children: brand })), brand && !brandSlug && (_jsx(Span, { layout: "inline-flex", size: "xs", weight: "medium", border: "subtle", rounded: "full", padding: "pill-sm-tall", surface: "muted", color: "muted", children: brand }))] })), bundleMemberships.length > 0 && (_jsx(Row, { gap: "sm", wrap: true, children: bundleMemberships.map((b) => (_jsxs(Link, { href: String(ROUTES.PUBLIC.BUNDLE_DETAIL(b.id)), className: CLS_BUNDLE_PILL, children: [_jsx(Span, { "aria-hidden": "true", children: "\uD83D\uDCE6" }), "In bundle: ", b.title] }, b.id))) })), _jsx(ProductFeatureBadges, { featured: featured, freeShipping: freeShipping, codAvailable: codEnabled === true, codHref: String(ROUTES.PUBLIC.HOW_CHECKOUT_WORKS), emiAvailable: emiEnabled === true, emiHref: String(ROUTES.PUBLIC.HOW_EMI_WORKS), condition: condition ?? undefined, returnable: !finalSale, finalSale: finalSale, labels: {
                                         featured: "Featured",
                                         fasterDelivery: "Faster Delivery",
                                         ratedSeller: "Rated Seller",
@@ -217,6 +226,7 @@ export async function ProductDetailPageView({ slug, initialProduct, renderOfferA
                                         conditionBroken: "For Parts",
                                         conditionRefurbished: "Refurbished",
                                         returnable: "Returnable",
+                                        finalSale: "Final Sale",
                                         freeShipping: "Free Shipping",
                                         codAvailable: "Cash on Delivery",
                                         emiAvailable: "EMI Available",
@@ -246,7 +256,9 @@ export async function ProductDetailPageView({ slug, initialProduct, renderOfferA
                                                 minOfferPercent,
                                                 allowOffers,
                                             }),
-                                        })] }), (shippingInfo || returnPolicy || freeShipping) && (_jsxs(Stack, { gap: "sm", border: "default", className: "border-t", padding: "t-md", children: [freeShipping && (_jsxs(Row, { align: "start", gap: "sm", children: [_jsx(Span, { className: CLS_FREE_SHIPPING_ICON, children: "\uD83D\uDE9A" }), _jsxs(Div, { children: [_jsx(Text, { size: "xs", weight: "medium", color: "muted", children: "Free Delivery" }), shippingInfo && (_jsx(Text, { size: "xs", color: "muted", children: shippingInfo }))] })] })), !freeShipping && shippingInfo && (_jsxs(Row, { align: "start", gap: "sm", children: [_jsx(Span, { className: "mt-0.5 flex-shrink-0", color: "faint", children: "\uD83D\uDCE6" }), _jsx(Text, { size: "xs", color: "muted", children: shippingInfo })] })), returnPolicy && (_jsxs(Row, { align: "start", gap: "sm", children: [_jsx(Span, { className: "mt-0.5 flex-shrink-0", color: "faint", children: "\u21BA" }), _jsx(Text, { size: "xs", color: "muted", children: returnPolicy })] }))] })), tags.length > 0 && (_jsxs(Div, { border: "default", className: "border-t", padding: "t-md", children: [_jsx(Text, { className: "mb-2", color: "muted", size: "xs", weight: "medium", children: "Tags" }), _jsx(Row, { wrap: true, gap: "xs", children: tags.map((tag) => (_jsx(Span, { rounded: "full", padding: "pill-sm-tall", surface: "subtle", color: "muted", size: "xs", children: tag }, tag))) })] })), _jsx(Div, { border: "default", className: "border-t", padding: "t-md", children: _jsx(Row, { wrap: true, gap: "sm", justify: "center", className: "text-center", children: [
+                                        })] }), (shippingInfo || returnPolicy || freeShipping || finalSale) && (_jsxs(Stack, { gap: "sm", border: "default", className: "border-t", padding: "t-md", children: [freeShipping && (_jsxs(Row, { align: "start", gap: "sm", children: [_jsx(Span, { className: CLS_FREE_SHIPPING_ICON, children: "\uD83D\uDE9A" }), _jsxs(Div, { children: [_jsx(Text, { size: "xs", weight: "medium", color: "muted", children: "Free Delivery" }), shippingInfo && (_jsx(Text, { size: "xs", color: "muted", children: shippingInfo }))] })] })), !freeShipping && shippingInfo && (_jsxs(Row, { align: "start", gap: "sm", children: [_jsx(Span, { className: CLS_POLICY_ROW_ICON, color: "faint", children: "\uD83D\uDCE6" }), _jsx(Text, { size: "xs", color: "muted", children: shippingInfo })] })), _jsxs(Row, { align: "start", gap: "sm", children: [_jsx(Span, { className: CLS_POLICY_ROW_ICON, color: "faint", children: "\u21BA" }), _jsxs(Div, { children: [_jsx(Text, { size: "xs", weight: "medium", color: finalSale ? "warning" : "muted", children: finalSale ? "Final sale — no change-of-mind returns" : "Returns accepted" }), _jsx(Text, { size: "xs", color: "muted", children: finalSale
+                                                                ? "You can still claim if it never arrives, arrives damaged, is the wrong item, is not as described, or is counterfeit."
+                                                                : "Return this item within the platform return window for any reason." })] })] }), returnPolicy && (_jsxs(Row, { align: "start", gap: "sm", children: [_jsx(Span, { className: CLS_POLICY_ROW_ICON, color: "faint", children: "\uD83D\uDCC4" }), _jsx(Text, { size: "xs", color: "muted", children: returnPolicy })] }))] })), tags.length > 0 && (_jsxs(Div, { border: "default", className: "border-t", padding: "t-md", children: [_jsx(Text, { className: "mb-2", color: "muted", size: "xs", weight: "medium", children: "Tags" }), _jsx(Row, { wrap: true, gap: "xs", children: tags.map((tag) => (_jsx(Span, { rounded: "full", padding: "pill-sm-tall", surface: "subtle", color: "muted", size: "xs", children: tag }, tag))) })] })), _jsx(Div, { border: "default", className: "border-t", padding: "t-md", children: _jsx(Row, { wrap: true, gap: "sm", justify: "center", className: "text-center", children: [
                                             { icon: "🔒", label: "Secure\nPayment" },
                                             { icon: "✓", label: "Verified\nSeller" },
                                             { icon: "⭐", label: "Quality\nGuarantee" },

package/dist/features/products/components/ProductFeatureBadges.d.ts

@@ -8,6 +8,7 @@ interface ProductFeatureBadgeLabels {
     conditionBroken: string;
     conditionRefurbished: string;
     returnable: string;
+    finalSale: string;
     freeShipping: string;
     codAvailable: string;
     emiAvailable: string;
@@ -20,6 +21,13 @@ interface ProductFeatureBadgesProps {
     ratedSeller?: boolean;
     condition?: string;
     returnable?: boolean;
+    /**
+     * Absent means final sale, so callers must resolve this through
+     * `isFinalSale()` rather than passing `product.finalSale` straight in.
+     * Mutually exclusive with `returnable` in practice, but both are accepted
+     * independently so a caller cannot accidentally render neither.
+     */
+    finalSale?: boolean;
     freeShipping?: boolean;
     wishlistCount?: number;
     categoryProductCount?: number;
@@ -34,5 +42,5 @@ interface ProductFeatureBadgesProps {
     formatCount?: (value: number) => string;
     categoryBadgeClassName?: string;
 }
-export declare function ProductFeatureBadges({ featured, fasterDelivery, ratedSeller, condition, returnable, freeShipping, wishlistCount, categoryProductCount, categoryName, codAvailable, codHref, emiAvailable, emiHref, labels, formatCount, categoryBadgeClassName, }: ProductFeatureBadgesProps): import("react").JSX.Element | null;
+export declare function ProductFeatureBadges({ featured, fasterDelivery, ratedSeller, condition, returnable, finalSale, freeShipping, wishlistCount, categoryProductCount, categoryName, codAvailable, codHref, emiAvailable, emiHref, labels, formatCount, categoryBadgeClassName, }: ProductFeatureBadgesProps): import("react").JSX.Element | null;
 export {};