@mohasinac/appkit 4.11.1 → 4.11.3

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

@@ -185,6 +185,22 @@ const rawTesterChecklistItems = [
                     description: "Verify against the seeded fixtures: \"Test Collectible — Sold Out\" (standard, hidden until \"Show sold\" is on), \"Test Auction — Already Won\" (hidden until \"Show ended\" is on), \"Test Prize Draw — Already Closed\" (hidden until \"Show closed\" is on). All three should be genuinely absent by default, not just from an unrelated broken query.",
                     href: "/products",
                 },
+                {
+                    key: "art-stickers-default-not-empty",
+                    label: "The Art & Stickers listing (/art) shows real items by default — not an empty grid that only populates after clicking \"Show sold\"",
+                    description: "Fixed 2026-08-21, two independent bugs: (1) \"art\"/\"stickers\" were missing from the repository's listing-type alias map, so the type filter was silently dropped and the query lost its listingType clause entirely on every path (SSR, /api/products, and the listingProcessor Function); (2) the SSR page pushed a stockQuantity>0 inequality into Firestore against a createdAt sort, which Firestore rejects, and the failure was swallowed into a bare empty page. Load /art fresh, with no filters touched, and confirm both Art and Sticker items are visible.",
+                    href: "/art",
+                },
+                {
+                    key: "art-stickers-type-chips-narrow",
+                    label: "On /art, the \"Art\" and \"Stickers\" type chips each narrow the grid to only that type — neither chip nor \"All\" ever returns zero rows",
+                    href: "/art",
+                },
+                {
+                    key: "art-stickers-show-sold-adds-not-reveals",
+                    label: "On /art, turning \"Show sold\" ON adds sold-out items to the grid (it should not be required to see anything at all)",
+                    href: "/art",
+                },
                 {
                     key: "auctions-show-ended-off-shows-live",
                     label: "With \"Show ended\" off (the default), the Auctions listing shows LIVE auctions — not empty, and not requiring the toggle to see anything",
@@ -441,7 +457,22 @@ const rawTesterChecklistItems = [
                 { key: "place-bid-live-self", label: "After placing a bid, the current bid amount and bid count update immediately on the auction page for the bidder — no manual page refresh needed" },
                 { key: "place-bid-live-other-viewer", label: "Opening the same auction in two browser tabs (or two accounts) and placing a bid in one updates the current bid and bid count in the other within a few seconds, without a manual refresh (realtime SSE)" },
                 { key: "outbid-notification", label: "Getting outbid triggers a notification" },
-                { key: "win-auction", label: "Winning an auction creates a payable order correctly", href: "/auctions/auction-tester-sandbox-won" },
+                {
+                    key: "win-auction",
+                    label: "Winning an auction creates a payable locked cart line, not a stuck order",
+                    description: "Fixed 2026-08-21 — settlement used to write a document that was not a real order (no items[], no buyerId, no payment method), so a winner had no way to pay anywhere in the product. Wait for `auction-tester-sandbox-won` to settle (or trigger the sweep manually), then confirm: a \"Won auction\" badge appears on the /user/bids row with a working \"Pay now\" link; the item shows up in the Cart's \"Won Auctions\" tab as a non-removable, non-editable line; and completing checkout produces a real order visible under the \"Auction wins\" tab on /user/orders.",
+                    href: "/auctions/auction-tester-sandbox-won",
+                },
+                {
+                    key: "auction-below-reserve-no-winner",
+                    label: "An auction that ends below its reserve price declares no winner and archives the listing, instead of awarding it to the highest bidder anyway",
+                    description: "Fixed 2026-08-21 — the reserve price was displayed and editable everywhere but never actually enforced at settlement.",
+                },
+                {
+                    key: "auction-win-unpaid-forfeit",
+                    label: "A won auction left unpaid past its 48-hour checkout window is removed from the cart and the bid is marked forfeited, with a notification to the buyer",
+                    description: "Requires waiting out the window (or adjusting the fixture's checkoutDeadline) — a background/low-priority case.",
+                },
                 { key: "bid-history", label: "My Bids page shows accurate bid history, paginated with the most recent bid first", href: "/user/bids" },
                 { key: "bid-history-auction-detail-pagination", label: "An auction detail page's Bid History section shows the most recent bid first and paginates once there are more bids than fit on one page (try the L-Drago auction — 13 seeded bids)" },
                 {
@@ -527,6 +558,191 @@ const rawTesterChecklistItems = [
                     label: "On mobile, cart item cards stay fully within the screen width per seller group — no horizontal overflow/clipping — and a floating checkout bar (styled like the bulk-action bar, sitting above the bottom nav) shows the total and a Checkout button, with enough bottom margin that the last cart item is never hidden behind it",
                     href: "/cart",
                 },
+                {
+                    key: "checkout-lanes-auction-blocks-others",
+                    label: "With a won auction pending, the cart's Offers and Cart tabs render their checkout button DISABLED with a stated reason, and adding any new item to the cart is refused",
+                    description: "Added 2026-08-21 (Checkout Lanes). Get a won auction into your cart (see win-auction), then try to: (a) check out from the Cart tab — button disabled, reason names the auction; (b) add a new standard product to cart — refused with the same reason, item does not appear.",
+                    href: "/cart",
+                },
+                {
+                    key: "checkout-lanes-offer-blocks-standard-only",
+                    label: "With an accepted offer pending (and no won auction), only the Cart tab's checkout is disabled — the Offers tab itself is checkoutable",
+                    href: "/cart",
+                },
+                {
+                    key: "checkout-lanes-totals-scoped",
+                    label: "Each cart tab's summary total reflects ONLY that tab's items — the Cart tab total never includes a pending auction or offer amount, and vice versa",
+                    href: "/cart",
+                },
+                {
+                    key: "checkout-lanes-checkout-page-matches-tab",
+                    label: "Opening checkout from a specific cart tab lands on the matching lane, shows only that lane's items and total, and (for Auction/Offer lanes) shows an info banner and hides the coupon field",
+                    href: "/checkout",
+                },
+            ],
+        },
+        {
+            pageKey: "buying-coupons",
+            pageLabel: "Coupons — Scoping & Stacking",
+            href: "/checkout",
+            cases: [
+                {
+                    key: "coupon-help-visible-cart",
+                    label: "The cart's order summary has an expandable \"How coupons work\" panel, collapsed by default",
+                    href: "/cart",
+                    description: "Open /cart with at least one item. Below the \"Apply coupons at checkout\" note there should be a collapsed \"How coupons work\" panel. Expand it and confirm it explains: one coupon per store, plus one platform-wide coupon, and why a coupon might not apply.",
+                },
+                {
+                    key: "coupon-help-visible-checkout",
+                    label: "The checkout coupon box has the same \"How coupons work\" panel, and it mentions re-checking at payment",
+                    description: "At checkout, below the coupon input and any error text. The checkout version has one extra line the cart version does not: that coupons are re-checked when you place the order. Confirm the wording matches the cart panel otherwise.",
+                },
+                {
+                    key: "coupon-help-visible-listing",
+                    label: "The public coupons listing shows the same \"How coupons work\" panel above the coupon grid",
+                    href: "/promotions",
+                    description: "Also check a store-scoped listing at /stores/store-beyblade-arena/coupons. Wording must be identical on all three surfaces (cart, checkout, listing) — any difference is a bug.",
+                },
+                {
+                    key: "coupon-stack-two-stores-plus-global",
+                    label: "Two store coupons AND one platform-wide coupon all apply to the same cart at once",
+                    description: "Build a cart with ≥₹1,000 from Beyblade Arena and ≥₹500 from LetItRip Official. At checkout apply ARENA25, then OFFICIAL10, then FREESHIP499. All three should stay applied and each should be listed in the applied-coupons list with its own discount amount. This is the headline behaviour — if any of the three is rejected, stop and report it.",
+                },
+                {
+                    key: "coupon-stack-second-store-coupon-rejected",
+                    label: "A second coupon for a store that already has one is declined with a clear message",
+                    description: "With ARENA25 applied, try SEALED20 (also Beyblade Arena). Expect a message naming the already-applied code, along the lines of \"A coupon for this store is already applied (ARENA25). Remove it first.\" The first coupon must stay applied — it must not be silently swapped.",
+                },
+                {
+                    key: "coupon-stack-second-global-rejected",
+                    label: "A second platform-wide coupon is declined with a clear message",
+                    description: "With FREESHIP499 applied, try BLADER50 (also platform-wide, needs ≥₹2,000). Expect \"Only one platform-wide coupon can be applied at a time (FREESHIP499). Remove it first.\" Then remove FREESHIP499 and confirm BLADER50 now applies — i.e. the slot frees up.",
+                },
+                {
+                    key: "coupon-stack-duplicate-code-rejected",
+                    label: "Applying the exact same code twice is declined",
+                    description: "Apply ARENA25, then type ARENA25 again. Expect \"Coupon ARENA25 is already applied.\" and no duplicate row in the applied list.",
+                },
+                {
+                    key: "coupon-store-scope-limited-to-its-own-items",
+                    label: "A store coupon only discounts that store's items, not the whole cart",
+                    description: "With items from both stores in the cart, apply only ARENA25 (25%, max ₹500). The discount must be computed from the Beyblade Arena items alone — it should NOT change if you add or remove LetItRip Official items (unless the Arena subtotal itself crosses the ₹1,000 minimum).",
+                },
+                {
+                    key: "coupon-min-purchase-uses-eligible-subtotal",
+                    label: "Minimum spend is measured against the coupon's eligible items, not the whole cart total",
+                    description: "ARENA25 needs ₹1,000. Put ₹600 of Beyblade Arena items plus ₹900 of LetItRip Official items in the cart — cart total is ₹1,500 but the Arena-eligible subtotal is only ₹600, so ARENA25 must be REJECTED for not meeting the minimum. A cart-total-based check would wrongly accept it.",
+                },
+                {
+                    key: "coupon-category-restriction-rejects-non-matching-cart",
+                    label: "A category-restricted coupon is rejected when the cart has none of those categories",
+                    description: "SEALED20 is restricted to the Burst and X categories. With a Beyblade Arena cart of ONLY Original/Metal-generation items, applying SEALED20 must be declined with a category-related message. Previously category restrictions were ignored entirely and it would have been accepted and discounted the whole store — that is the regression this case guards.",
+                },
+                {
+                    key: "coupon-category-restriction-accepts-matching-cart",
+                    label: "The same category-restricted coupon IS accepted once a matching item is in the cart",
+                    description: "Continuing from the case above: add a Burst or X generation Beyblade to the cart, then apply SEALED20 again. It should now be accepted, and the discount should be based only on the Burst/X items — not on the Original/Metal items sharing the cart.",
+                },
+                {
+                    key: "coupon-remove-one-of-many",
+                    label: "Removing one coupon from a stack leaves the others applied and recalculates the total",
+                    description: "With three coupons applied, remove the middle one. The other two must remain, the total must go up by exactly the removed coupon's amount, and the Order Summary discount line(s) must update to match.",
+                },
+                {
+                    key: "coupon-summary-total-matches-sum",
+                    label: "The Order Summary's discount equals the sum of the applied coupons",
+                    description: "With a stack applied, add up the individual coupon amounts in the applied-coupons list and compare against the \"Coupon discount\" line in the Order Summary. They must agree. Also confirm the Total equals Subtotal − discount + shipping + fees + GST.",
+                },
+                {
+                    key: "coupon-persists-across-reload",
+                    label: "Applied coupons survive a page reload and are still there when you return to checkout",
+                    description: "Apply a stack, reload the checkout page, and confirm all coupons are still listed with the same amounts. Then navigate to the cart and back to checkout — still there.",
+                },
+                {
+                    key: "coupon-split-across-per-store-orders",
+                    label: "After placing a multi-store order, each store's order shows its own share of the discount",
+                    href: "/user/orders",
+                    description: "Check out a multi-store cart carrying a platform-wide coupon plus at least one store coupon. A multi-store cart creates one order PER STORE. Open each resulting order: the store coupon must appear only on its own store's order, the platform-wide coupon must appear on every order as a proportional share, and the shares across all orders must add up to the discount shown at checkout.",
+                },
+                {
+                    key: "coupon-all-codes-listed-on-order",
+                    label: "An order placed with several coupons lists every one of them, not just the first",
+                    href: "/user/orders",
+                    description: "Open the order detail page and the invoice page for an order placed with 2+ coupons. Both must show a separate discount line per coupon, each naming its code. Previously only the first coupon's code was shown — a single \"Discount (CODE)\" line for a multi-coupon order is the bug this case guards.",
+                },
+                {
+                    key: "coupon-expired-in-cart-dropped-at-placement",
+                    label: "A coupon that expired while sitting in the cart is dropped at placement instead of being honoured",
+                    description: "Needs an admin: apply a coupon at checkout, then have an admin deactivate or expire it in /admin/coupons, then place the order without touching the cart. The order must be priced WITHOUT that coupon, and the buyer must be told it was removed — the order must not silently charge the pre-discount amount without explanation, and must not honour a dead coupon.",
+                },
+                {
+                    key: "coupon-usage-limit-increments-after-order",
+                    label: "Placing an order increments the coupon's usage count and counts against your per-user limit",
+                    description: "Note a coupon's current usage in /admin/coupons, place an order using it, then re-check. Usage must have gone up by one. Then, for a coupon with perUserLimit 1, try to apply it again on a new cart — it must be refused as limit-reached.",
+                },
+                {
+                    key: "coupon-wallet-apply-lands-on-checkout",
+                    label: "\"Use\" on a claimed coupon in My Coupons carries the code through to checkout",
+                    href: "/user/coupons",
+                    description: "From /user/coupons press Use on an active coupon. You should end up on checkout with that coupon already applied (it may route via /cart first). If the coupon can't apply to your current cart, the reason must be shown rather than failing silently.",
+                },
+                {
+                    key: "coupon-auction-offer-lane-no-coupon-field",
+                    label: "Auction and Offer checkout lanes hide the coupon field entirely",
+                    description: "Open checkout from the Auction or Offer cart tab. The coupon input and the \"How coupons work\" panel should not be shown at all for those lanes, and an info banner should explain why.",
+                },
+            ],
+        },
+        {
+            pageKey: "offers",
+            pageLabel: "Offers",
+            href: "/products",
+            cases: [
+                {
+                    key: "make-offer",
+                    label: "Making an offer on a product's detail page works and the seller receives a notification",
+                    href: "/products",
+                },
+                {
+                    key: "seller-sees-and-can-act-on-offers",
+                    label: "A seller's Offers page (/store/offers) actually lists incoming offers, and Accept / Decline / Counter all work from the row menu",
+                    description: "Fixed 2026-08-21 — the page rendered the view with no handlers at all (so the row menu had nothing but a status badge), and separately the view read an API response key (`offers`) the route never sent (it sends `items`), so the list rendered empty even before the handler gap. Make an offer as a buyer, then confirm the seller can see it, open its details, and Accept/Decline/Counter each work.",
+                    href: "/store/offers",
+                },
+                {
+                    key: "buyer-sees-offer-status-changes",
+                    label: "\"My Offers\" (/user/offers) actually lists the buyer's offers and reflects accept/decline/counter as the seller responds",
+                    description: "Fixed 2026-08-21 — the panel read `json.items` off a response the API always wraps as `{success, data:{items}}`, so it showed \"No offers yet\" for every buyer regardless of how many offers existed.",
+                    href: "/user/offers",
+                },
+                {
+                    key: "offer-seller-can-read-before-acting",
+                    label: "Before accepting/declining/countering, the seller can open a \"View details\" panel showing the buyer's note, listed vs. offered price, and expiry — not just a bare row with action buttons",
+                    href: "/store/offers",
+                },
+                {
+                    key: "counter-offer-has-a-form",
+                    label: "Countering an offer opens a form asking for the counter amount (and an optional note) — it is not a bare confirm with no input",
+                    description: "Fixed 2026-08-21 — the counter action previously took no input at all, so it had no real caller anywhere in the codebase.",
+                    href: "/store/offers",
+                },
+                {
+                    key: "offer-accept-checkout-charges-agreed-price",
+                    label: "Accepting an offer, then completing checkout from the Offers cart tab, charges the NEGOTIATED price — not the listing's current price",
+                    description: "Fixed 2026-08-21 — every copy of the checkout price calculation ignored the offer's locked price and billed the listing price instead, while the cart UI displayed the correct negotiated figure — so the buyer saw one number and was charged another. Accept an offer below the listing price, complete checkout, and confirm the order total matches the AGREED amount.",
+                    href: "/user/offers",
+                },
+                {
+                    key: "offer-flips-to-paid-after-order",
+                    label: "After completing checkout on an accepted offer, the offer's status becomes \"paid\" and it can't be added to the cart or checked out again",
+                    description: "Fixed 2026-08-21 — the \"paid\" status existed in the schema but had no server-side writer anywhere, so an accepted offer stayed re-orderable indefinitely.",
+                    href: "/user/offers",
+                },
+                {
+                    key: "offer-expired-accepted-cannot-checkout",
+                    label: "An accepted offer past its 48-hour checkout window can no longer be checked out, and is cleared from the cart with a notification to the buyer",
+                    description: "Background/low-priority — requires waiting out the window or adjusting the fixture's checkoutDeadline.",
+                },
             ],
         },
         {
@@ -713,6 +929,24 @@ const rawTesterChecklistItems = [
             href: "/store/products",
             cases: [
                 { key: "seller-coupons-crud", label: "Seller can create, edit, and list their own coupons", href: "/store/coupons" },
+                {
+                    key: "seller-coupon-auto-scoped-to-own-store",
+                    label: "A seller-created coupon is automatically scoped to that seller's own store, with no store picker",
+                    href: "/store/coupons/new",
+                    description: "The coupon form must NOT offer a store selector — the store is taken from the logged-in seller. After creating one, confirm it only discounts that store's items when a buyer applies it, and that it can be stacked alongside a different store's coupon.",
+                },
+                {
+                    key: "seller-coupon-no-stacking-toggle",
+                    label: "The seller coupon form has no \"allow stacking\" option — stacking is always permitted",
+                    href: "/store/coupons/new",
+                    description: "Stacking is now governed by scope alone (one per store + one platform-wide), so any leftover stacking checkbox on this form is a bug.",
+                },
+                {
+                    key: "seller-coupon-category-restriction-works",
+                    label: "Restricting a seller coupon to specific categories actually limits which items it discounts",
+                    href: "/store/coupons/new",
+                    description: "Create a coupon restricted to one category, then as a buyer put a non-matching item from that store in the cart and try the code — it must be refused. Add a matching item and confirm the discount covers only the matching item's value.",
+                },
                 { key: "seller-bundles-crud", label: "Seller can create, edit, and list bundles/grouped listings", href: "/store/bundles" },
                 { key: "seller-classified-crud", label: "Seller can create, edit, and list classified listings", href: "/store/classified" },
                 { key: "seller-digitalcodes-crud", label: "Seller can create, edit, and list digital-code listings", href: "/store/digital-codes" },
@@ -1077,6 +1311,80 @@ const rawTesterChecklistItems = [
                 },
             ],
         },
+        {
+            pageKey: "carousel-arrow-bounds",
+            pageLabel: "Carousel Arrows — Card Boundaries",
+            href: "/",
+            cases: [
+                {
+                    key: "arrows-never-cover-cards",
+                    label: "On a laptop/desktop, the carousel's ← / → arrows sit in their own empty strip to the left and right of the cards — no part of any card (image, title, price, badge, button) is ever hidden behind an arrow",
+                    description: "Fixed 2026-08-21. Previously the arrows were drawn ON TOP of the cards: an opaque white circle sat over the card's left and right edges, cutting into the title and image. The arrows should now read as boundary walls with the cards living strictly between them.",
+                    href: "/",
+                },
+                {
+                    key: "arrows-no-overlap-mid-scroll",
+                    label: "Scroll a carousel to a HALFWAY position (drag it, or click → once and stop mid-way) and confirm the cards are still cleanly cut off at the inner edge of the arrow strip — a card must never slide underneath an arrow while scrolling",
+                    description: "This is the single most important case — the old bug was invisible at rest and only appeared once you scrolled. The arrows looked fine on first load, then cards slid under them the moment the row moved. Check several carousels, and stop scrolling at a few different in-between positions.",
+                    href: "/",
+                },
+                {
+                    key: "no-arrows-on-mobile",
+                    label: "On a phone, carousels show NO ← / → arrow buttons at all — you scroll them by swiping",
+                    description: "Intentional as of 2026-08-21: on a narrow screen the arrows would eat roughly 60px of card width, so they are hidden below tablet size and swiping is the only control. Seeing arrows on a phone is now a bug.",
+                    href: "/",
+                },
+                {
+                    key: "mobile-card-not-clipped",
+                    label: "On a phone, a carousel card fills the row edge-to-edge and is NOT cut off on either side — its title, price and button are fully visible without any part running off-screen",
+                    description: "Fixed 2026-08-21. Cards used to be rendered wider than the space available, so both the left and right edges were chopped off simultaneously. Compare against the section heading above it: the card should line up with the section's own left/right margins.",
+                    href: "/",
+                },
+                {
+                    key: "mobile-swipe-and-snap",
+                    label: "On a phone, swiping a carousel still scrolls it, and it settles neatly on one card at a time rather than stopping halfway between two cards",
+                    href: "/",
+                },
+                {
+                    key: "no-white-fade-smear",
+                    label: "There is no washed-out white gradient smear at the left/right ends of a carousel — especially on sections that have a coloured or photo background, where a white haze would look obviously wrong",
+                    description: "The old fade-edge effect was removed on 2026-08-21 because the arrow gutters now mark the boundary. Check a section with a background image (if one is configured) as well as a plain one, in both light and dark mode.",
+                    href: "/",
+                },
+                {
+                    key: "two-row-tall-arrows",
+                    label: "On a section that shows TWO rows of cards (e.g. Reserve Before It Ships / Live Auctions when configured for 2 rows), the taller full-height arrow bars also sit beside the cards, not over them",
+                    href: "/",
+                },
+                {
+                    key: "arrows-dark-mode",
+                    label: "In dark mode the carousel arrows are still clearly visible against the page and sit in the same position beside the cards as in light mode",
+                    href: "/",
+                },
+                {
+                    key: "arrow-end-state-no-jump",
+                    label: "Clicking → repeatedly to the end of a carousel that does not loop dims/greys the → arrow, and the cards do NOT shift sideways when that happens",
+                    href: "/",
+                },
+                {
+                    key: "resize-across-breakpoint",
+                    label: "On a desktop browser, slowly narrow the window until it is phone-width and back again — the arrows disappear/reappear at the size change and the cards re-fit cleanly each time, never ending up underneath an arrow",
+                    description: "Easiest with the browser's responsive/device-toolbar mode. Drag the width slowly rather than jumping between presets.",
+                    href: "/",
+                },
+                {
+                    key: "related-carousels-same-behaviour",
+                    label: "The \"You might also like\" / related-items carousels lower down a PRODUCT page behave exactly the same as the homepage ones — arrows beside the cards, nothing covered, no arrows on mobile",
+                    description: "These are a different surface using the same underlying scroller, so they are the best check that the fix applied everywhere rather than only on the homepage.",
+                    href: "/products/product-tester-standard-1",
+                },
+                {
+                    key: "category-page-carousels-same-behaviour",
+                    label: "Carousels on a CATEGORY page (e.g. related groups / bundles strips) behave the same — arrows beside the cards, nothing covered",
+                    href: "/categories/category-beyblade-burst",
+                },
+            ],
+        },
     ]),
     ...group("public-pages", "Public & Marketing Pages", [
         {
@@ -1241,6 +1549,34 @@ const rawTesterChecklistItems = [
                 { key: "coupon-min-max-discount", label: "Admin-set minPurchase and maxDiscount are correctly enforced at checkout" },
                 { key: "coupon-scope-admin-vs-seller", label: "Admin-scope and seller-scope coupons both apply correctly, respecting scope rules" },
                 { key: "coupon-expire-reject", label: "Expiring a coupon from the admin editor causes checkout to reject it immediately" },
+                {
+                    key: "coupon-admin-is-platform-wide",
+                    label: "An admin-created coupon applies across every store in the cart, not just one",
+                    href: "/admin/coupons/new",
+                    description: "Admin coupons have no store field — they are platform-wide by design. Create one, then as a buyer apply it to a cart holding items from two different stores and confirm the discount is spread across both stores' items.",
+                },
+                {
+                    key: "coupon-admin-no-stacking-toggle",
+                    label: "The admin coupon form no longer has an \"Allow stacking with seller coupons\" toggle",
+                    href: "/admin/coupons/new",
+                    description: "Stacking is now unconditional (one per store + one platform-wide), so that toggle was removed. Its presence — or any saved coupon still blocking a seller coupon from stacking — is a bug.",
+                },
+                {
+                    key: "coupon-admin-category-restriction-enforced",
+                    label: "Restricting an admin coupon to categories actually limits which items it discounts",
+                    href: "/admin/coupons/new",
+                    description: "Create a platform-wide coupon restricted to one category. A cart with none of that category must have the code refused; a cart with some must discount only those items. Leaving the category list empty must keep the coupon applicable to everything.",
+                },
+                {
+                    key: "coupon-admin-edit-actually-saves",
+                    label: "Editing a coupon's name, discount, limits or dates actually persists after reload",
+                    description: "Change several fields at once, save, then hard-reload the edit page. Every change must still be there. A save that returns success but shows the old values after reload is a bug.",
+                },
+                {
+                    key: "coupon-admin-usage-visible",
+                    label: "The admin coupon list shows usage counts that go up after a buyer redeems the coupon",
+                    description: "Note the current usage, have a buyer complete an order with the coupon, then refresh the admin list. Check this for BOTH a cash/UPI order and (if Razorpay is enabled) an online-payment order — online payments previously did not record usage at all.",
+                },
             ],
         },
         {

package/dist/index.d.ts

@@ -2457,7 +2457,7 @@ export { getProductFilterKeys } from "./features/products/index";
 export { getProductSortOptions } from "./features/products/index";
 export { getProductTableColumns } from "./features/products/index";
 export { normalizeListingType, isAuctionListing, isPreOrderListing, isStandardListing, isPrizeDrawListing, isClassifiedListing, isDigitalCodeListing, isLiveListing, isArtListing, isStickersListing, } from "./features/products/index";
-export { isListingTypeEnabled, isCategoryTypeEnabled, enabledListingTypes, enabledCategoryTypes, } from "./_internal/shared/listing-types/feature-flags";
+export { isListingTypeEnabled, isCategoryTypeEnabled, enabledListingTypes, enabledCategoryTypes, ALL_LISTING_TYPES, } from "./_internal/shared/listing-types/feature-flags";
 export { actionTracker, setActionTrackerSink, resetActionTrackerSink, type ActionEvent, type ActionTrackerSink, } from "./_internal/shared/listing-types/action-tracker";
 export { cartRequiresShipping, cartIsDigitalOnly, cartIsChatOnly, } from "./_internal/shared/listing-types/cart-shipping";
 export { ACTIONS, action, act, canPerformAction, actionsForListingType, actionLabel, type ActionDef, type ActionKind, type ActionResource, type ActionTree, type ActionConfirmation, } from "./_internal/shared/actions/action-registry";
@@ -2538,6 +2538,8 @@ export { COUPON_FIELDS } from "./features/promotions/index";
 export { COUPON_TYPE_LABELS } from "./features/promotions/index";
 export { COUPON_USAGE_SUBCOLLECTION } from "./features/promotions/index";
 export { CouponCard } from "./features/promotions/index";
+export { CouponHelpDetails } from "./features/promotions/index";
+export type { CouponHelpDetailsProps } from "./features/promotions/index";
 export { CouponsIndexListing } from "./features/promotions/index";
 export type { CouponsIndexListingProps } from "./features/promotions/index";
 export { DEFAULT_COUPON_DATA } from "./features/promotions/index";
@@ -2583,6 +2585,8 @@ export type { RestrictionsConfig } from "./features/promotions/index";
 export type { TieredDiscount } from "./features/promotions/index";
 export type { UsageConfig } from "./features/promotions/index";
 export type { ValidityConfig } from "./features/promotions/index";
+export { detectCouponConflict } from "./features/promotions/server";
+export type { IncomingCoupon } from "./features/promotions/server";
 export { getPromotions } from "./features/promotions/server";
 export { promotionsGET } from "./features/promotions/server";
 export { sellerCreateCoupon } from "./features/promotions/server";
@@ -3133,9 +3137,11 @@ export type { ProductFeatureAdminCreatePayload, ProductFeatureStoreCreatePayload
 export { LISTING_PARAM_NAMES, parseListingParams, parseListingSearchParams, serializeListingParams, } from "./utils/listing-params";
 export type { ListingParams } from "./utils/listing-params";
 export { PRODUCT_FEATURE_CATEGORY_OPTIONS, PRODUCT_FEATURE_PRODUCT_TYPE_OPTIONS, PRODUCT_FEATURE_SCOPE_OPTIONS, PRODUCT_FEATURE_ICON_COLOR_OPTIONS, PRODUCT_FEATURE_SCOPE_TABS, PRODUCT_FEATURE_DEFAULT_DISPLAY_ORDER, PRODUCT_FEATURE_CARD_MAX_VISIBLE, PRODUCT_FEATURE_QUERY_STALE_MS, } from "./features/products/constants/product-features.constants";
-export { CATEGORY_PAGE_TABS, STORE_PAGE_TABS, SELLER_LISTING_TABS, SEARCH_RESULT_TABS, } from "./features/products/constants/listing-tabs";
-export type { ListingTab, CategoryTabId, StoreTabId, SellerListingTabId, SearchTabId, } from "./features/products/constants/listing-tabs";
-export { STANDARD_SORT_OPTIONS, STANDARD_PUBLIC_SORT_OPTIONS, AUCTION_SORT_OPTIONS, AUCTION_PUBLIC_SORT_OPTIONS, PREORDER_SORT_OPTIONS, BUNDLE_SORT_OPTIONS, PRIZE_DRAW_SORT_OPTIONS, SORT_OPTIONS_BY_LISTING_TYPE, } from "./features/products/constants/sieve";
+export { CATEGORY_PAGE_TABS, STORE_PAGE_TABS, SELLER_LISTING_TABS, PRODUCT_TYPE_FILTER_TABS, ART_STICKERS_TYPE_FILTER_TABS, GENERIC_PRODUCT_LISTING_TYPES, ART_STICKERS_LISTING_TYPES, } from "./features/products/constants/listing-tabs";
+export type { ListingTab, CategoryTabId, StoreTabId, SellerListingTabId, } from "./features/products/constants/listing-tabs";
+export { STANDARD_SORT_OPTIONS, STANDARD_PUBLIC_SORT_OPTIONS, AUCTION_SORT_OPTIONS, AUCTION_PUBLIC_SORT_OPTIONS, PREORDER_SORT_OPTIONS, PREORDER_PUBLIC_SORT_OPTIONS, BUNDLE_SORT_OPTIONS, PRIZE_DRAW_SORT_OPTIONS, PRIZE_DRAW_PUBLIC_SORT_OPTIONS, } from "./features/products/constants/sieve";
+export { sortOptionsFor, commonSortOptionsFor, hideDefaultsFor, } from "./_internal/shared/listing-types/_registry";
+export type { ListingHideDefault } from "./_internal/shared/listing-types/_registry";
 export type { SortOption } from "./features/products/constants/sieve";
 export { ALL_TAB, EMPTY_TAB, ADMIN_PRODUCT_STATUS_TABS, ADMIN_PRODUCT_LISTING_TYPE_TABS, ADMIN_BLOG_STATUS_TABS, ADMIN_USER_STATUS_TABS, ADMIN_USER_ROLE_TABS, ADMIN_STORE_STATUS_TABS, ADMIN_PAYOUT_STATUS_TABS, ADMIN_ORDER_STATUS_TABS, ADMIN_REVIEW_STATUS_TABS, ADMIN_REVIEW_RATING_TABS, ADMIN_BID_STATUS_TABS, ADMIN_CONTACT_STATUS_TABS, ADMIN_NEWSLETTER_STATUS_TABS, ADMIN_EVENT_ENTRY_STATUS_TABS, ADMIN_EVENT_STATUS_TABS, ADMIN_CART_OWNERSHIP_TABS, ADMIN_COUPON_TYPE_TABS, SELLER_PRODUCT_STATUS_TABS, SELLER_AUCTION_STATUS_TABS, SELLER_ORDER_STATUS_TABS, SELLER_OFFER_STATUS_TABS, SELLER_BID_STATUS_TABS, } from "./features/admin/constants/filter-tabs";
 export type { AdminFilterTab } from "./features/admin/constants/filter-tabs";
@@ -3264,3 +3270,4 @@ export { safeFireAndForget } from "./utils/safe-fire-forget";
 export { withRetry } from "./http/retry";
 export { normalizeError, getErrorMessage, isApiNormalized, isAppNormalized, isFirebaseAuthNormalized, isFirebaseFirestoreNormalized, isFirebaseStorageNormalized, isNativeNormalized, isNetworkNormalized, isUnknownNormalized, isZodNormalized, } from "./errors/normalize";
 export type { NormalizedError, NormalizedApiError, NormalizedAppError, NormalizedFirebaseAuthError, NormalizedFirebaseFirestoreError, NormalizedFirebaseStorageError, NormalizedNativeError, NormalizedNetworkError, NormalizedUnknownThrownValue, NormalizedZodError, } from "./errors/normalize";
+export { CART_LANE, CART_LANE_PRIORITY, CART_LANE_LABELS, laneOf, activeLane, laneItems, laneCounts, isLaneCheckoutable, laneBlockReason, isLockedLane, canAddNewItems, type CartLane, type LaneAssignable, } from "./_internal/shared/checkout/lanes";

package/dist/index.js

@@ -4463,7 +4463,7 @@ export { getProductTableColumns } from "./features/products/index";
 // SB-UNI-F 2026-05-13 â€" Phase 2 predicates added (classified/digital-code/live).
 export { normalizeListingType, isAuctionListing, isPreOrderListing, isStandardListing, isPrizeDrawListing, isClassifiedListing, isDigitalCodeListing, isLiveListing, isArtListing, isStickersListing, } from "./features/products/index";
 // SB-UNI-X4 2026-05-13 â€" per-type feature-flag helpers.
-export { isListingTypeEnabled, isCategoryTypeEnabled, enabledListingTypes, enabledCategoryTypes, } from "./_internal/shared/listing-types/feature-flags";
+export { isListingTypeEnabled, isCategoryTypeEnabled, enabledListingTypes, enabledCategoryTypes, ALL_LISTING_TYPES, } from "./_internal/shared/listing-types/feature-flags";
 // SB-UNI-X5 2026-05-13 â€" action telemetry sink.
 export { actionTracker, setActionTrackerSink, resetActionTrackerSink, } from "./_internal/shared/listing-types/action-tracker";
 // SB-UNI-S 2026-05-13 â€" cart-level shipping-requirement helpers.
@@ -4583,6 +4583,8 @@ export { COUPON_USAGE_SUBCOLLECTION } from "./features/promotions/index";
 // [CLIENT-SSR]-Runs in both SSR and browser â€" React component or hook that does not depend on browser-only APIs.
 // CouponCard - Component for coupon card.
 export { CouponCard } from "./features/promotions/index";
+// CouponHelpDetails - Expandable "How coupons work" explainer (scoping + stacking rules).
+export { CouponHelpDetails } from "./features/promotions/index";
 // CouponsIndexListing - Client component for browsing coupons with search/filter/sort.
 export { CouponsIndexListing } from "./features/promotions/index";
 // [SCHEMA]-Schema / data-shape constant â€" Zod validator, default-value object, or Firestore collection/field name constant.
@@ -4649,6 +4651,9 @@ export { useCouponValidate } from "./features/promotions/index";
 // usePromotions - React hook for use promotions.
 export { usePromotions } from "./features/promotions/index";
 // ./features/promotions/server
+// [SERVER-ONLY]-Server-only â€" uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).
+// detectCouponConflict - Coupon stacking rule: one seller coupon per store + one admin coupon per cart.
+export { detectCouponConflict } from "./features/promotions/server";
 // [DB]-Database layer â€" uses firebase-admin or another server-side DB SDK; can only run in a trusted server environment.
 // getPromotions - Helper for get promotions.
 export { getPromotions } from "./features/promotions/server";
@@ -5534,8 +5539,12 @@ export { LISTING_PARAM_NAMES, parseListingParams, parseListingSearchParams, seri
 // Product features UI option lists (S8 refactor â€" shared by editor + selector)
 export { PRODUCT_FEATURE_CATEGORY_OPTIONS, PRODUCT_FEATURE_PRODUCT_TYPE_OPTIONS, PRODUCT_FEATURE_SCOPE_OPTIONS, PRODUCT_FEATURE_ICON_COLOR_OPTIONS, PRODUCT_FEATURE_SCOPE_TABS, PRODUCT_FEATURE_DEFAULT_DISPLAY_ORDER, PRODUCT_FEATURE_CARD_MAX_VISIBLE, PRODUCT_FEATURE_QUERY_STALE_MS, } from "./features/products/constants/product-features.constants";
 // SB10-A listing tab constants
-export { CATEGORY_PAGE_TABS, STORE_PAGE_TABS, SELLER_LISTING_TABS, SEARCH_RESULT_TABS, } from "./features/products/constants/listing-tabs";
-export { STANDARD_SORT_OPTIONS, STANDARD_PUBLIC_SORT_OPTIONS, AUCTION_SORT_OPTIONS, AUCTION_PUBLIC_SORT_OPTIONS, PREORDER_SORT_OPTIONS, BUNDLE_SORT_OPTIONS, PRIZE_DRAW_SORT_OPTIONS, SORT_OPTIONS_BY_LISTING_TYPE, } from "./features/products/constants/sieve";
+export { CATEGORY_PAGE_TABS, STORE_PAGE_TABS, SELLER_LISTING_TABS, PRODUCT_TYPE_FILTER_TABS, ART_STICKERS_TYPE_FILTER_TABS, GENERIC_PRODUCT_LISTING_TYPES, ART_STICKERS_LISTING_TYPES, } from "./features/products/constants/listing-tabs";
+export { STANDARD_SORT_OPTIONS, STANDARD_PUBLIC_SORT_OPTIONS, AUCTION_SORT_OPTIONS, AUCTION_PUBLIC_SORT_OPTIONS, PREORDER_SORT_OPTIONS, PREORDER_PUBLIC_SORT_OPTIONS, BUNDLE_SORT_OPTIONS, PRIZE_DRAW_SORT_OPTIONS, PRIZE_DRAW_PUBLIC_SORT_OPTIONS, } from "./features/products/constants/sieve";
+// The per-type sort lookup is DERIVED from the listing-type plugin registry
+// (it used to be a hand-written map here that was missing five of the nine
+// types and still listed the long-dead `bundle` listingType).
+export { sortOptionsFor, commonSortOptionsFor, hideDefaultsFor, } from "./_internal/shared/listing-types/_registry";
 // SB10-C admin + seller filter-chip tab sets (S8 2026-05-13)
 export { ALL_TAB, EMPTY_TAB, ADMIN_PRODUCT_STATUS_TABS, ADMIN_PRODUCT_LISTING_TYPE_TABS, ADMIN_BLOG_STATUS_TABS, ADMIN_USER_STATUS_TABS, ADMIN_USER_ROLE_TABS, ADMIN_STORE_STATUS_TABS, ADMIN_PAYOUT_STATUS_TABS, ADMIN_ORDER_STATUS_TABS, ADMIN_REVIEW_STATUS_TABS, ADMIN_REVIEW_RATING_TABS, ADMIN_BID_STATUS_TABS, ADMIN_CONTACT_STATUS_TABS, ADMIN_NEWSLETTER_STATUS_TABS, ADMIN_EVENT_ENTRY_STATUS_TABS, ADMIN_EVENT_STATUS_TABS, ADMIN_CART_OWNERSHIP_TABS, ADMIN_COUPON_TYPE_TABS, SELLER_PRODUCT_STATUS_TABS, SELLER_AUCTION_STATUS_TABS, SELLER_ORDER_STATUS_TABS, SELLER_OFFER_STATUS_TABS, SELLER_BID_STATUS_TABS, } from "./features/admin/constants/filter-tabs";
 // Grouped listings feature schemas
@@ -5666,3 +5675,6 @@ export { withRetry } from "./http/retry";
 // Every catch (e: unknown) funnels through normalizeError(e) which returns
 // a NormalizedError discriminated union. Audit-catch-normalize enforces this.
 export { normalizeError, getErrorMessage, isApiNormalized, isAppNormalized, isFirebaseAuthNormalized, isFirebaseFirestoreNormalized, isFirebaseStorageNormalized, isNativeNormalized, isNetworkNormalized, isUnknownNormalized, isZodNormalized, } from "./errors/normalize";
+// Checkout lanes — the derived auction > offer > standard partition of the
+// cart, and the priority rule that decides which one may be checked out.
+export { CART_LANE, CART_LANE_PRIORITY, CART_LANE_LABELS, laneOf, activeLane, laneItems, laneCounts, isLaneCheckoutable, laneBlockReason, isLockedLane, canAddNewItems, } from "./_internal/shared/checkout/lanes";

package/dist/react/hooks/useListingTypeFlags.d.ts

@@ -1,3 +1,4 @@
+import type { ListingType } from "../../features/products/types/index";
 /**
  * W1-43 — useListingTypeFlags
  *
@@ -8,25 +9,17 @@
  * Defaults to all-enabled when settings haven't loaded yet — match the
  * permissive default used by `DEFAULT_SITE_SETTINGS_DATA` so first paint
  * doesn't briefly hide enabled features.
+ *
+ * KEYED ON THE UNION, NOT A HAND-WRITTEN LIST (2026-08-21). Both types below
+ * used to enumerate seven types by hand and had never been updated for `art`
+ * and `stickers` — so `isEnabled("art")` didn't even typecheck, and the seller
+ * TypeDropdown (its main consumer) could not offer either type. Deriving from
+ * `ListingType` makes a missing member a compile error, matching the same
+ * decision made for `ALL_LISTING_TYPES_MAP` in `feature-flags.ts`.
  */
-export type ListingTypeFlagsShape = Partial<{
-    standard: boolean;
-    auction: boolean;
-    "pre-order": boolean;
-    "prize-draw": boolean;
-    classified: boolean;
-    "digital-code": boolean;
-    live: boolean;
-}>;
-export interface ListingTypeFlags {
-    standard: boolean;
-    auction: boolean;
-    "pre-order": boolean;
-    "prize-draw": boolean;
-    classified: boolean;
-    "digital-code": boolean;
-    live: boolean;
+export type ListingTypeFlagsShape = Partial<Record<ListingType, boolean>>;
+export type ListingTypeFlags = Record<ListingType, boolean> & {
     /** True when the listing type is enabled (or the setting hasn't loaded yet). */
-    isEnabled: (type: "standard" | "auction" | "pre-order" | "prize-draw" | "classified" | "digital-code" | "live") => boolean;
-}
+    isEnabled: (type: ListingType) => boolean;
+};
 export declare function useListingTypeFlags(): ListingTypeFlags;

package/dist/react/hooks/useListingTypeFlags.js

@@ -1,17 +1,12 @@
 "use client";
 import { useSiteSettings } from "../../core/hooks/useSiteSettings";
+import { ALL_LISTING_TYPES } from "../../_internal/shared/listing-types/feature-flags";
 export function useListingTypeFlags() {
     const { data } = useSiteSettings();
     const lt = data?.featureFlags?.listingTypes;
-    const flags = {
-        standard: lt?.standard !== false,
-        auction: lt?.auction !== false,
-        "pre-order": lt?.["pre-order"] !== false,
-        "prize-draw": lt?.["prize-draw"] !== false,
-        classified: lt?.classified !== false,
-        "digital-code": lt?.["digital-code"] !== false,
-        live: lt?.live !== false,
-    };
+    // A type is disabled only when EXPLICITLY set to false — a missing flag (or
+    // settings that haven't loaded) means enabled.
+    const flags = Object.fromEntries(ALL_LISTING_TYPES.map((type) => [type, lt?.[type] !== false]));
     return {
         ...flags,
         isEnabled: (type) => flags[type],