@mohasinac/appkit 4.24.0 → 4.26.0

package/dist/features/orders/utils/bundle-grouping.js

@@ -7,47 +7,57 @@
  * checkout receipt mirrors the buyer's intent. This helper is the pure
  * grouping logic — the UI primitive lives next to the consumer view.
  *
- * Two flavours of "bundle row" can appear on an order:
- *   1. ONE order row whose `bundleCategorySlug` + `bundleProductIds[]` set
- *      describe the bundle (this is what S-SBUNI-4's checkout writes — the
- *      bundle stays a single row in the order with the locked
- *      bundlePrice as its line total).
- *   2. (Future) Expanded N rows, each tagged with the same
- *      `bundleCategorySlug`. The grouping handles this too in case a future
- *      session pivots to row expansion.
+ * Two flavours of multi-member row can appear on an order:
+ *   1. LEGACY — ONE row whose `bundleCategorySlug` + `bundleProductIds[]`
+ *      describe the whole bundle, with the locked bundlePrice as its line
+ *      total. Every bundle order placed before row expansion looks like this,
+ *      and they keep rendering unchanged.
+ *   2. CURRENT — expanded N rows, one per member, all sharing a `groupSlug`
+ *      (and, for bundles, the same `bundleCategorySlug`). This is what
+ *      checkout writes now, so each row can carry its own HSN/GST and be
+ *      cancelled independently.
  *
- * Either way, `groupOrderItemsByBundle` returns a stable, ordered list of
- * "groups" so the renderer can iterate once.
+ * Either way this returns a stable, ordered list of groups so the renderer
+ * iterates once and the buyer's receipt reads the same.
  */
 /**
- * Walk the items array preserving original order; collapse contiguous (or
- * non-contiguous) bundle rows sharing the same `bundleCategorySlug` into a
- * single group. Single rows pass through unchanged.
+ * Walk the items array preserving original order; collapse rows sharing a
+ * collapse key into one group. Single rows pass through unchanged.
+ *
+ * The key is `groupSlug ?? bundleCategorySlug` — the fallback is what keeps
+ * legacy collapsed bundle rows (written before `groupSlug` existed) grouping
+ * exactly as they always did, with no order migration.
  */
-export function groupOrderItemsByBundle(items) {
+export function groupOrderItemsByLine(items) {
     const groups = [];
-    const bundleIndexBySlug = new Map();
+    const indexByKey = new Map();
     items.forEach((item, index) => {
-        const slug = item.bundleCategorySlug;
-        if (!slug) {
+        const key = item.groupSlug ?? item.bundleCategorySlug;
+        if (!key) {
             groups.push({ kind: "single", item, index });
             return;
         }
-        const existingIdx = bundleIndexBySlug.get(slug);
+        const existingIdx = indexByKey.get(key);
         if (existingIdx === undefined) {
-            const memberCount = item.bundleProductIds?.length ?? 1;
             groups.push({
                 kind: "bundle",
-                bundleCategorySlug: slug,
+                bundleCategorySlug: key,
+                groupTitle: item.groupTitle,
+                // Legacy rows carry the member list; expanded rows ARE the members, so
+                // the count is grown as siblings arrive below.
+                memberCount: item.bundleProductIds?.length ?? 1,
                 items: [{ item, index }],
-                memberCount,
             });
-            bundleIndexBySlug.set(slug, groups.length - 1);
+            indexByKey.set(key, groups.length - 1);
             return;
         }
         const existing = groups[existingIdx];
         if (existing.kind === "bundle") {
             existing.items.push({ item, index });
+            // Expanded rows: one row per member, so the row count IS the member count.
+            if (!item.bundleProductIds?.length) {
+                existing.memberCount = existing.items.length;
+            }
         }
     });
     return groups;

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

@@ -0,0 +1,46 @@
+/**
+ * GroupMemberPicker — pick which members of a group you want, and how many of
+ * each, then add the whole selection as ONE cart line.
+ *
+ * This is the "pick as you wish" half of the grouped-purchase model. Bundles
+ * are the other half and deliberately do NOT use this: a bundle is priced as a
+ * whole and is all-or-nothing, so its members render read-only and the only
+ * stepper is the bundle's own copy count.
+ *
+ * Two mount points, one component: the "Part of: …" modal/drawer on a product
+ * detail page, and the public `/groups/{slug}` page.
+ *
+ * The component talks to the API directly rather than taking an `onAdd` server
+ * action prop. That keeps `ShowGroupSection`'s `renderGroupSection` slot
+ * signature unchanged, which in turn leaves both detail-page views and both
+ * consumer pages untouched.
+ */
+import React from "react";
+import type { ListingType } from "../types";
+export interface GroupPickerMember {
+    id: string;
+    title: string;
+    price: number;
+    currency?: string;
+    images?: string[];
+    image?: string;
+    slug?: string;
+    listingType?: ListingType;
+    isGroupParent?: boolean;
+    condition?: string;
+    availableQuantity?: number;
+    storeId?: string;
+    storeName?: string;
+    isSold?: boolean;
+    status?: string;
+}
+export interface GroupMemberPickerProps {
+    groupId: string;
+    groupSource: "product-group" | "grouped-listing";
+    members: GroupPickerMember[];
+    /** Called after a successful add so the host can close its overlay. */
+    onAdded?: () => void;
+    /** Called when the API reports the caller isn't signed in. */
+    onAuthRequired?: () => void;
+}
+export declare function GroupMemberPicker({ groupId, groupSource, members, onAdded, onAuthRequired, }: GroupMemberPickerProps): React.JSX.Element;

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

@@ -0,0 +1,108 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/**
+ * GroupMemberPicker — pick which members of a group you want, and how many of
+ * each, then add the whole selection as ONE cart line.
+ *
+ * This is the "pick as you wish" half of the grouped-purchase model. Bundles
+ * are the other half and deliberately do NOT use this: a bundle is priced as a
+ * whole and is all-or-nothing, so its members render read-only and the only
+ * stepper is the bundle's own copy count.
+ *
+ * Two mount points, one component: the "Part of: …" modal/drawer on a product
+ * detail page, and the public `/groups/{slug}` page.
+ *
+ * The component talks to the API directly rather than taking an `onAdd` server
+ * action prop. That keeps `ShowGroupSection`'s `renderGroupSection` slot
+ * signature unchanged, which in turn leaves both detail-page views and both
+ * consumer pages untouched.
+ */
+import { useMemo, useState } from "react";
+import { Alert, Button, Div, Row, Span, Stack, Table, Tbody, Td, Text, Th, Thead, Tr, } from "../../../ui";
+import { QuantityStepper } from "../../../ui/components/QuantityStepper";
+import { MediaImage } from "../../media/MediaImage";
+import { formatCurrency } from "../../../utils/number.formatter";
+import { ACTIONS } from "../../../_internal/shared/actions/action-registry";
+import { CART_ENDPOINTS } from "../../../constants/api-endpoints";
+import { normalizeError } from "../../../errors/normalize";
+import { pluginFor } from "../../../_internal/shared/listing-types/_registry";
+import { normalizeListingType } from "../utils/listing-type";
+const __O = { xAuto: "overflow-x-auto", hidden: "overflow-hidden" };
+function memberImage(m) {
+    return m.image ?? m.images?.[0] ?? "";
+}
+function memberHref(m) {
+    return pluginFor(normalizeListingType(m)).detailRoute(m.slug ?? m.id);
+}
+/** A member the buyer cannot choose, and the reason to show instead of a stepper. */
+function blockedReason(m) {
+    if (m.isSold)
+        return "Sold";
+    if (m.status && m.status !== "published")
+        return "Unavailable";
+    if ((m.availableQuantity ?? 0) <= 0)
+        return "Out of stock";
+    // `cartLine: "blocked"` is how a classified / live listing says "contact the
+    // seller instead" — those can never join a cart line.
+    if (pluginFor(normalizeListingType(m)).cartLine === "blocked")
+        return "Not purchasable here";
+    return null;
+}
+export function GroupMemberPicker({ groupId, groupSource, members, onAdded, onAuthRequired, }) {
+    const [qty, setQty] = useState({});
+    const [isSaving, setIsSaving] = useState(false);
+    const [error, setError] = useState(null);
+    // A group whose members span sellers cannot become one cart line: storeId is
+    // the order-splitting key and the key per-store add-ons, coupons, shipping and
+    // payout all hang off. Rather than offer a button that always fails, the
+    // picker stands down and the table stays read-only.
+    const storeIds = useMemo(() => new Set(members.map((m) => m.storeId).filter(Boolean)), [members]);
+    const isCrossStore = storeIds.size > 1;
+    const selected = useMemo(() => members
+        .map((m) => ({ member: m, quantity: qty[m.id] ?? 0 }))
+        .filter((s) => s.quantity > 0), [members, qty]);
+    const selectedTotal = selected.reduce((sum, s) => sum + s.member.price * s.quantity, 0);
+    const selectedUnits = selected.reduce((sum, s) => sum + s.quantity, 0);
+    const currency = members[0]?.currency ?? "INR";
+    const handleAdd = async () => {
+        setError(null);
+        setIsSaving(true);
+        try {
+            const res = await fetch(CART_ENDPOINTS.GROUP, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({
+                    groupId,
+                    groupSource,
+                    // Ids and quantities only. Prices and titles are re-resolved on the
+                    // server — anything else would be a price-manipulation hole.
+                    members: selected.map((s) => ({ productId: s.member.id, quantity: s.quantity })),
+                }),
+            });
+            if (res.status === 401) {
+                onAuthRequired?.();
+                return;
+            }
+            const json = (await res.json());
+            if (!res.ok || json.success === false) {
+                setError(json.error ?? "Couldn't add those items to your cart.");
+                return;
+            }
+            setQty({});
+            onAdded?.();
+        }
+        catch (err) {
+            void normalizeError(err);
+            setError("Couldn't reach the server. Please try again.");
+        }
+        finally {
+            setIsSaving(false);
+        }
+    };
+    return (_jsxs(Stack, { gap: "sm", children: [isCrossStore && (_jsx(Alert, { variant: "info", children: "These items are sold by different sellers, so they can't be combined into one cart line. Open an item to buy it on its own." })), _jsx(Div, { className: __O.xAuto, children: _jsxs(Table, { className: "text-left min-w-[440px]", children: [_jsx(Thead, { children: _jsxs(Tr, { border: "default", children: [_jsx(Th, { paddingY: "sm", paddingSide: "pr-sm", color: "muted", size: "xs", weight: "semibold", children: "Image" }), _jsx(Th, { paddingY: "sm", paddingSide: "pr-sm", color: "muted", size: "xs", weight: "semibold", children: "Name" }), _jsx(Th, { paddingY: "sm", paddingSide: "pr-sm", color: "muted", size: "xs", weight: "semibold", children: "Price" }), !isCrossStore && (_jsx(Th, { paddingY: "sm", paddingSide: "pr-sm", color: "muted", size: "xs", weight: "semibold", children: "Qty" })), _jsx(Th, { paddingY: "sm", paddingSide: "pb-sm", color: "muted", size: "xs", weight: "semibold" })] }) }), _jsx(Tbody, { children: members.map((m) => {
+                                const blocked = blockedReason(m);
+                                return (_jsxs(Tr, { className: "last:border-0", border: "subtle", children: [_jsx(Td, { paddingSide: "pr-sm", padding: "xs-tall", children: _jsx(Div, { className: `w-10 h-10 ${__O.hidden}`, rounded: "full", border: "default", children: _jsx(MediaImage, { src: memberImage(m), alt: m.title, size: "thumbnail" }) }) }), _jsxs(Td, { paddingSide: "pr-sm", padding: "xs-tall", children: [_jsx(Text, { className: "line-clamp-2", color: "primary", size: "sm", weight: "medium", children: m.title }), m.isGroupParent && (_jsx(Span, { weight: "semibold", className: "text-[10px] text-[var(--appkit-color-primary)]", children: "Parent" }))] }), _jsx(Td, { paddingSide: "pr-sm", padding: "xs-tall", children: _jsx(Text, { size: "sm", color: "muted", children: formatCurrency(m.price, m.currency ?? currency) }) }), !isCrossStore && (_jsx(Td, { paddingSide: "pr-sm", padding: "xs-tall", children: blocked ? (_jsx(Span, { size: "xs", color: "muted", surface: "muted", rounded: "default", padding: "pill-2xs", children: blocked })) : (_jsx(QuantityStepper, { value: qty[m.id] ?? 0, onChange: (next) => setQty((prev) => ({ ...prev, [m.id]: next })), min: 0, max: m.availableQuantity, ariaLabel: `Quantity for ${m.title}`, decrementLabel: ACTIONS.CART["decrease-quantity"].ariaLabel, incrementLabel: ACTIONS.CART["increase-quantity"].ariaLabel })) })), _jsx(Td, { padding: "xs-tall", children: _jsx("a", { href: memberHref(m), className: "text-[length:var(--appkit-text-xs)] text-[var(--appkit-color-primary)] hover:underline", children: "View \u2192" }) })] }, m.id));
+                            }) })] }) }), !isCrossStore && (_jsxs(_Fragment, { children: [error && _jsx(Alert, { variant: "error", children: error }), _jsxs(Row, { justify: "between", align: "center", gap: "sm", className: "min-w-0", children: [_jsx(Text, { size: "sm", color: "muted", children: selectedUnits > 0
+                                    ? `${selectedUnits} item${selectedUnits === 1 ? "" : "s"} · ${formatCurrency(selectedTotal, currency)}`
+                                    : "Nothing selected yet" }), _jsx(Button, { action: ACTIONS.CART["add-group-to-cart"], disabled: selectedUnits === 0, isLoading: isSaving, onClick: handleAdd })] })] }))] }));
+}

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

@@ -2,8 +2,9 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { useEffect, useState } from "react";
 import Link from "next/link";
-import { Div, Row, Span, Table, Thead, Tbody, Tr, Th, Td, Text, Modal, SideDrawer, Button } from "../../../ui";
+import { Div, Row, Span, Text, Modal, SideDrawer, Button } from "../../../ui";
 import { MediaImage } from "../../media/MediaImage";
+import { GroupMemberPicker } from "./GroupMemberPicker";
 import { formatCurrency } from "../../../utils/number.formatter";
 import { normalizeListingType } from "../utils/listing-type";
 import { pluginFor } from "../../../_internal/shared/listing-types/_registry";
@@ -24,12 +25,6 @@ function MemberThumb({ member, isCurrent }) {
                     ? "border-[var(--appkit-color-primary)] ring-2 ring-[var(--appkit-color-primary)]/30"
                     : "border-[var(--appkit-color-border)] group-hover:border-[var(--appkit-color-primary)]"}`, children: [_jsx(MediaImage, { src: image, alt: member.title, size: "card" }), member.isGroupParent && (_jsx(Span, { color: "inverse", rounded: "sm", className: "absolute bottom-0 right-0 bg-[var(--appkit-color-primary)] text-[8px] leading-none px-[0.25rem] py-[0.125rem]", children: "Set" }))] }), _jsx(Text, { className: "text-[10px] leading-tight line-clamp-2 w-full", color: "muted", align: "start", children: member.title }), _jsx(Text, { className: "text-[10px]", color: "primary", weight: "semibold", children: price })] }));
 }
-function GroupTableRow({ member }) {
-    const href = memberHref(member);
-    const price = formatCurrency(member.price, member.currency ?? "INR");
-    const image = member.images?.[0] ?? "";
-    return (_jsxs(Tr, { className: "last:border-0", border: "subtle", children: [_jsx(Td, { paddingSide: "pr-sm", padding: "xs-tall", children: _jsx(Div, { className: `w-10 h-10 ${__O.hidden}`, rounded: "full", border: "default", children: _jsx(MediaImage, { src: image, alt: member.title, size: "thumbnail" }) }) }), _jsxs(Td, { paddingSide: "pr-sm", padding: "xs-tall", children: [_jsx(Text, { className: "line-clamp-2", color: "primary", size: "sm", weight: "medium", children: member.title }), member.isGroupParent && (_jsx(Span, { weight: "semibold", className: "text-[10px] text-[var(--appkit-color-primary)]", children: "Parent" }))] }), _jsx(Td, { paddingSide: "pr-sm", padding: "xs-tall", children: _jsx(Text, { size: "sm", color: "muted", children: price }) }), _jsx(Td, { paddingSide: "pr-sm", padding: "xs-tall", children: _jsx(Text, { size: "xs", transform: "capitalize", color: "muted", children: member.condition ?? "—" }) }), _jsx(Td, { padding: "xs-tall", children: _jsx(Link, { href: href, className: "text-[length:var(--appkit-text-xs)] text-[var(--appkit-color-primary)] hover:underline", children: "View \u2192" }) })] }));
-}
 export function ShowGroupSection({ groupId, currentSlug, isParent, groupTitle }) {
     const [open, setOpen] = useState(false);
     const [members, setMembers] = useState([]);
@@ -50,11 +45,14 @@ export function ShowGroupSection({ groupId, currentSlug, isParent, groupTitle })
     const label = groupTitle ?? "Product group";
     const parentLabel = isParent ? `Parts in this group: ${label}` : `Part of: ${label}`;
     const useDrawer = members.length >= 5;
-    const tableContent = (_jsx(Div, { className: `${__O.xAuto}`, children: _jsxs(Table, { className: "text-left min-w-[400px]", children: [_jsx(Thead, { children: _jsxs(Tr, { border: "default", children: [_jsx(Th, { paddingY: "sm", paddingSide: "pr-sm", color: "muted", size: "xs", weight: "semibold", children: "Image" }), _jsx(Th, { paddingY: "sm", paddingSide: "pr-sm", color: "muted", size: "xs", weight: "semibold", children: "Name" }), _jsx(Th, { paddingY: "sm", paddingSide: "pr-sm", color: "muted", size: "xs", weight: "semibold", children: "Price" }), _jsx(Th, { paddingY: "sm", paddingSide: "pr-sm", color: "muted", size: "xs", weight: "semibold", children: "Condition" }), _jsx(Th, { paddingY: "sm", paddingSide: "pb-sm", color: "muted", size: "xs", weight: "semibold" })] }) }), _jsx(Tbody, { children: members.map((m) => _jsx(GroupTableRow, { member: m }, m.id)) })] }) }));
+    // The overlay is now a PICKER, not a read-only table: pick how many of each
+    // member you want and add the whole selection as one cart line. The picker
+    // stands itself down (read-only, no CTA) when the group spans sellers.
+    const tableContent = (_jsx(GroupMemberPicker, { groupId: groupId, groupSource: "product-group", members: members, onAdded: () => setShowAll(false), onAuthRequired: () => setShowAll(false) }));
     return (_jsxs(_Fragment, { children: [_jsxs(Div, { className: `${__O.hidden}`, surface: "muted", rounded: "xl", border: "default", children: [_jsxs(Row, { role: "button", tabIndex: 0, onClick: () => setOpen((v) => !v), onKeyDown: (e) => { if (e.key === "Enter" || e.key === " ") {
                             e.preventDefault();
                             setOpen((v) => !v);
-                        } }, justify: "between", paddingX: "x-md", paddingY: "y-sm", className: "w-full cursor-pointer text-left hover:bg-[var(--appkit-color-surface-elevated)]/70 transition-colors", "aria-expanded": open, children: [_jsxs(Row, { align: "center", gap: "xs", children: [_jsx(Span, { size: "xs", className: "mr-1", color: "faint", children: open ? "▼" : "▶" }), _jsx(Text, { size: "sm", weight: "medium", color: "primary", children: parentLabel }), _jsx(Span, { size: "xs", className: "ml-1", rounded: "full", padding: "pill-xs", surface: "subtle", color: "muted", children: members.length })] }), _jsx(Button, { type: "button", variant: "ghost", size: "sm", onClick: (e) => { e.stopPropagation(); setShowAll(true); }, className: "text-[length:var(--appkit-text-xs)] text-[var(--appkit-color-primary)] hover:underline ml-3 flex-shrink-0", children: "View whole group \u2192" })] }), open && (_jsx(Div, { className: `pb-[1rem] pt-[0.25rem] ${__O.xAuto}`, padding: "x-md", children: _jsx(Row, { gap: "3", className: "min-w-0", children: [...members]
+                        } }, justify: "between", paddingX: "x-md", paddingY: "y-sm", className: "w-full cursor-pointer text-left hover:bg-[var(--appkit-color-surface-elevated)]/70 transition-colors", "aria-expanded": open, children: [_jsxs(Row, { align: "center", gap: "xs", children: [_jsx(Span, { size: "xs", className: "mr-1", color: "faint", children: open ? "▼" : "▶" }), _jsx(Text, { size: "sm", weight: "medium", color: "primary", children: parentLabel }), _jsx(Span, { size: "xs", className: "ml-1", rounded: "full", padding: "pill-xs", surface: "subtle", color: "muted", children: members.length })] }), _jsx(Button, { type: "button", variant: "ghost", size: "sm", onClick: (e) => { e.stopPropagation(); setShowAll(true); }, className: "text-[length:var(--appkit-text-xs)] text-[var(--appkit-color-primary)] hover:underline ml-3 flex-shrink-0", children: "Pick items \u2192" })] }), open && (_jsx(Div, { className: `pb-[1rem] pt-[0.25rem] ${__O.xAuto}`, padding: "x-md", children: _jsx(Row, { gap: "3", className: "min-w-0", children: [...members]
                                 .sort((a, b) => (b.isGroupParent ? 1 : 0) - (a.isGroupParent ? 1 : 0))
                                 .map((m) => (_jsx(MemberThumb, { member: m, isCurrent: m.slug === currentSlug || m.id === currentSlug }, m.id))) }) }))] }), useDrawer ? (_jsx(SideDrawer, { isOpen: showAll, onClose: () => setShowAll(false), title: label, children: tableContent })) : (_jsx(Modal, { open: showAll, onClose: () => setShowAll(false), title: label, children: tableContent }))] }));
 }

package/dist/features/tester/seed-data/categories-tester-seed-data.js

@@ -188,6 +188,12 @@ export const categoriesTesterSeedData = [
         bundleProductIds: ["product-tester-standard-1", "product-tester-standard-2"],
         bundleOriginalTotal: 348, // 199 + 149
         bundleStockStatus: "in_stock",
+        // Without these, `addBundleToCartAction` wrote `storeId: ""` on the cart
+        // line, which produced an order group keyed `standard:` with an undefined
+        // storeId — no seller notification, no shipping resolution, no payout. The
+        // bug was seeded in, so it reproduced on every tester run.
+        createdByStoreId: "store-tester-qa-seller",
+        createdByStoreName: "Tester Sandbox Store",
         rootId: "bundle-tester-sandbox",
         parentIds: [],
         childrenIds: [],

package/dist/features/tester/seed-data/products-tester-seed-data.js

@@ -232,6 +232,9 @@ export const productsTesterSeedData = [
         customSections: [],
         isPromoted: false,
         isOnSale: false,
+        // 18% — contrasts with member #3's 12% so one grouped line spans two rates.
+        gstRate: 18,
+        hsnCode: "95030090",
         // Child of the "group-tester-sandbox-bundle" product-group ("Set") parent
         // below — findByGroupId() queries products by this field directly, so
         // without it the parent's groupChildSlugs[] mirror is never actually
@@ -265,6 +268,40 @@ export const productsTesterSeedData = [
         customSections: [],
         isPromoted: false,
         isOnSale: false,
+        gstRate: 18,
+        hsnCode: "95030090",
+        groupId: "group-tester-sandbox-bundle",
+        groupParentSlug: "group-tester-sandbox-bundle",
+        groupTitle: TESTER_GROUP_TITLE,
+        createdAt: new Date(),
+        updatedAt: new Date(),
+    }),
+    withTokens({
+        id: "product-tester-standard-3",
+        slug: "product-tester-standard-3",
+        title: "Test Sticker Pack — Standard Listing #3",
+        description: "Third member of the test product group. Carries a DIFFERENT gstRate from its siblings on purpose: it is the only fixture that exercises per-member GST proration on a grouped/bundled cart line, where taxing the whole line at one product's rate would be wrong in both directions. Auto-expires in 7 days.",
+        categorySlugs: COLLECTIBLES_CATEGORY_SLUGS,
+        categoryNames: COLLECTIBLES_CATEGORY_NAMES,
+        brandSlug: "brand-tester-sandbox",
+        brand: "TestBrand",
+        price: 99,
+        currency: "INR",
+        stockQuantity: 10,
+        availableQuantity: 10,
+        isSold: false,
+        mainImage: seedExtMedia("https://picsum.photos/seed/product-image-tester-standard-3-20260101/900/900"),
+        images: [seedExtMedia("https://picsum.photos/seed/product-image-tester-standard-3-20260101/900/900")],
+        status: PRODUCT_FIELDS.STATUS_VALUES.PUBLISHED,
+        condition: PRODUCT_FIELDS.CONDITION_VALUES.NEW,
+        listingType: "standard",
+        customFields: [],
+        customSections: [],
+        isPromoted: false,
+        isOnSale: false,
+        // 12% against the siblings' 18% — the whole point of this fixture.
+        gstRate: 12,
+        hsnCode: "49081000",
         groupId: "group-tester-sandbox-bundle",
         groupParentSlug: "group-tester-sandbox-bundle",
         groupTitle: TESTER_GROUP_TITLE,
@@ -644,7 +681,13 @@ export const productsTesterSeedData = [
         isGroupParent: true,
         groupId: "group-tester-sandbox-bundle",
         groupTitle: TESTER_GROUP_TITLE,
-        groupChildSlugs: ["product-tester-standard-1", "product-tester-standard-2"],
+        // Parent↔child mirror: every id here must also carry `groupId` on its own
+        // document. The pair drifting is Root Cause #42's second instance.
+        groupChildSlugs: [
+            "product-tester-standard-1",
+            "product-tester-standard-2",
+            "product-tester-standard-3",
+        ],
         createdAt: new Date(),
         updatedAt: new Date(),
     }),

package/dist/features/tester/seed-data/tester-checklist-seed-data.js

@@ -729,6 +729,39 @@ const rawTesterChecklistItems = [
             href: "/cart",
             cases: [
                 { key: "update-qty", label: "Updating item quantity in cart recalculates the total" },
+                {
+                    key: "group-picker-add-selected",
+                    label: "On a product that is part of a group, \"Pick items →\" opens a picker with +/- per member, and \"Add selected to cart\" creates ONE cart line (not one per item)",
+                    description: "Use the Test Gadget page. Set two different members to different quantities, check the running total in the picker footer, then add. The cart should show a single line, not three.",
+                    href: "/products/product-tester-standard-1",
+                },
+                {
+                    key: "group-line-editable-in-cart",
+                    label: "A grouped cart line expands to show its members, each with its own +/- and remove; removing the last member removes the whole line",
+                    description: "There should be NO line-level quantity stepper on a grouped line — the per-member steppers carry the whole selection. Changing one member should update both the line total and the seller subtotal.",
+                    href: "/cart",
+                },
+                {
+                    key: "group-picker-cross-store",
+                    label: "A group whose members belong to different sellers shows the read-only table with no quantity column and an explanation, rather than an \"Add selected\" button that always fails",
+                    href: "/products/product-tester-standard-1",
+                },
+                {
+                    key: "bundle-copies-stepper",
+                    label: "A bundle page has a \"Copies\" +/- stepper and BOTH \"Buy now\" and \"Add to cart\" — Add to cart stays on the page, Buy now goes to checkout",
+                    description: "A bundle is all-or-nothing: there must be no per-member quantity controls on the bundle page, only the copies stepper.",
+                    href: "/bundles/bundle-tester-sandbox",
+                },
+                {
+                    key: "bundle-line-editable-in-cart",
+                    label: "A bundle in the cart shows its member list read-only and a copies stepper; changing copies recalculates the line at the bundle's discounted price, not the sum of member prices",
+                    href: "/cart",
+                },
+                {
+                    key: "grouped-listing-page-picker",
+                    label: "A grouped listing has its own page with the same picker, reachable from the \"Pick items from this group →\" button on a group carousel",
+                    href: "/groups/group-beyblade-original-lineage",
+                },
                 { key: "apply-coupon", label: "Applying a coupon code at checkout works" },
                 { key: "remove-coupon", label: "Removing an already-applied coupon from the cart recalculates the total back down" },
                 { key: "remove-item", label: "Removing an item from the cart works" },

package/dist/index.d.ts

@@ -1551,7 +1551,8 @@ export { updateBlogPostSchema } from "./features/blog/server";
 export type { BlogPostDetailResponse } from "./features/blog/server";
 export type { CreateBlogPostInput } from "./features/blog/server";
 export type { UpdateBlogPostInput } from "./features/blog/server";
-export { addItemToCart, assertCanAddNewItems } from "./features/cart/server";
+export { addItemToCart, assertCanAddNewItems, addGroupLineToCart, updateCartGroupMembers, GROUP_LINE_MAX_MEMBERS, type AddGroupLineToCartInput, } from "./features/cart/server";
+export { toPublicGroupMember, toPublicGroupMembers, type PublicGroupMember, } from "./_internal/server/features/products/group-members";
 export { clearCart } from "./features/cart/server";
 export { getCart } from "./features/cart/server";
 export { mergeGuestCart } from "./features/cart/server";
@@ -3124,7 +3125,7 @@ export type { SessionUser } from "./react/index";
 export type { UseUrlTableOptions } from "./react/index";
 export { SUCCESS_MESSAGES } from "./values/index";
 export { splitCartIntoOrderGroups } from "./features/orders/index";
-export { groupOrderItemsByBundle, type BundleOrderGroup, type OrderItemForBundleGrouping, } from "./features/orders/index";
+export { groupOrderItemsByLine, type LineOrderGroup, type OrderItemForLineGrouping, } from "./features/orders/index";
 export { buildSieveFilters } from "./utils/filter.helper";
 export { formatCurrency, formatFileSize } from "./utils/number.formatter";
 export { formatMonthYear } from "./utils/date.formatter";

package/dist/index.js

@@ -2912,7 +2912,11 @@ export { updateBlogPostSchema } from "./features/blog/server";
 // [SERVER-ONLY]-Server-only â€" uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).
 // addItemToCart - Helper for add item to cart.
 // assertCanAddNewItems - the lane gate every add-to-cart entry point must run.
-export { addItemToCart, assertCanAddNewItems } from "./features/cart/server";
+// addGroupLineToCart - add a buyer-assembled group selection as ONE line.
+export { addItemToCart, assertCanAddNewItems, addGroupLineToCart, updateCartGroupMembers, GROUP_LINE_MAX_MEMBERS, } from "./features/cart/server";
+// Public allow-list projection for a product-group member — see
+// § "Public Data Projections".
+export { toPublicGroupMember, toPublicGroupMembers, } from "./_internal/server/features/products/group-members";
 // [SERVER-ONLY]-Server-only â€" uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).
 // clearCart - Shared export for clear cart.
 export { clearCart } from "./features/cart/server";
@@ -5526,7 +5530,7 @@ export { SUCCESS_MESSAGES } from "./values/index";
 // -- Missing order utils
 export { splitCartIntoOrderGroups } from "./features/orders/index";
 // S-SBUNI-5 2026-05-13 â€" bundle-aware order item grouping for receipts.
-export { groupOrderItemsByBundle, } from "./features/orders/index";
+export { groupOrderItemsByLine, } from "./features/orders/index";
 // -- Missing utils
 export { buildSieveFilters } from "./utils/filter.helper";
 export { formatCurrency, formatFileSize } from "./utils/number.formatter";

package/dist/next/routing/route-map.d.ts

@@ -25,6 +25,12 @@ export declare const DEFAULT_ROUTE_MAP: {
         readonly PRE_ORDER_DETAIL: (id: string) => string;
         readonly BUNDLES: "/bundles";
         readonly BUNDLE_DETAIL: (slug: string) => string;
+        /**
+         * A `groupedListings` document's public page. Distinct from a product
+         * GROUP (`product.groupId`), whose canonical page is its parent product's
+         * detail page — see § "Bundles vs Product Groups vs Grouped Listings".
+         */
+        readonly GROUP_DETAIL: (slug: string) => string;
         readonly PRIZE_DRAWS: "/prize-draws";
         readonly PRIZE_DRAW_DETAIL: (slug: string) => string;
         readonly SELLER_GUIDE_BUNDLES: "/seller-guide/bundles";
@@ -407,6 +413,12 @@ export declare const ROUTES: {
         readonly PRE_ORDER_DETAIL: (id: string) => string;
         readonly BUNDLES: "/bundles";
         readonly BUNDLE_DETAIL: (slug: string) => string;
+        /**
+         * A `groupedListings` document's public page. Distinct from a product
+         * GROUP (`product.groupId`), whose canonical page is its parent product's
+         * detail page — see § "Bundles vs Product Groups vs Grouped Listings".
+         */
+        readonly GROUP_DETAIL: (slug: string) => string;
         readonly PRIZE_DRAWS: "/prize-draws";
         readonly PRIZE_DRAW_DETAIL: (slug: string) => string;
         readonly SELLER_GUIDE_BUNDLES: "/seller-guide/bundles";

package/dist/next/routing/route-map.js

@@ -14,6 +14,12 @@ export const DEFAULT_ROUTE_MAP = {
         // SB1-J — bundles + prize draws (additive, pages not yet built)
         BUNDLES: "/bundles",
         BUNDLE_DETAIL: (slug) => `/bundles/${slug}`,
+        /**
+         * A `groupedListings` document's public page. Distinct from a product
+         * GROUP (`product.groupId`), whose canonical page is its parent product's
+         * detail page — see § "Bundles vs Product Groups vs Grouped Listings".
+         */
+        GROUP_DETAIL: (slug) => `/groups/${slug}`,
         PRIZE_DRAWS: "/prize-draws",
         PRIZE_DRAW_DETAIL: (slug) => `/prize-draws/${slug}`,
         SELLER_GUIDE_BUNDLES: "/seller-guide/bundles",