@mohasinac/appkit 2.6.3 → 2.6.5

package/dist/features/cart/components/ShippingPicker.js

@@ -0,0 +1,48 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * ShippingPicker — buyer-facing shipping provider selector.
+ *
+ * Renders the store's configured shipping providers as a radio list.
+ * The selected provider's id + calculated fee are surfaced via the
+ * `onPickProvider` callback so the parent can persist them to the cart item.
+ */
+import { useState } from "react";
+import { Button, Div, Row, Stack, Text } from "../../../ui";
+import { formatCurrency } from "../../../utils/number.formatter";
+import { REFUND_COPY } from "../../../_internal/shared/features/orders/refund-copy";
+/** Resolve the effective flat fee for a provider given the current subtotal. */
+function resolveProviderFee(p, subtotalInPaise) {
+    const { fee } = p;
+    if (fee.freeAboveInPaise !== undefined && subtotalInPaise >= fee.freeAboveInPaise)
+        return 0;
+    let total = fee.flatInPaise ?? 0;
+    if (fee.percentOfOrder !== undefined) {
+        total += Math.round((fee.percentOfOrder / 100) * subtotalInPaise);
+    }
+    if (fee.minInPaise !== undefined)
+        total = Math.max(total, fee.minInPaise);
+    return total;
+}
+export function ShippingPicker({ providers, selectedProviderId, subtotalInPaise = 0, onPickProvider, isLoading = false, className = "", }) {
+    const [pending, setPending] = useState(false);
+    if (providers.length === 0) {
+        return (_jsx(Text, { size: "sm", color: "muted", className: className, children: REFUND_COPY.shipping.noOptions }));
+    }
+    const handleSelect = async (p) => {
+        const fee = resolveProviderFee(p, subtotalInPaise);
+        setPending(true);
+        try {
+            await onPickProvider(p.providerId, fee);
+        }
+        finally {
+            setPending(false);
+        }
+    };
+    return (_jsx(Stack, { gap: "xs", className: className, role: "radiogroup", "aria-label": "Shipping options", children: providers.map((p) => {
+            const fee = resolveProviderFee(p, subtotalInPaise);
+            const selected = p.providerId === selectedProviderId;
+            const disabled = isLoading || pending;
+            return (_jsx(Button, { type: "button", variant: selected ? "primary" : "outline", size: "sm", disabled: disabled, onClick: () => handleSelect(p), "aria-checked": selected, role: "radio", className: "w-full justify-start text-left", children: _jsxs(Row, { gap: "sm", className: "w-full flex-wrap", align: "center", children: [_jsxs(Div, { className: "flex-1", children: [_jsx(Text, { size: "sm", weight: selected ? "semibold" : "normal", children: p.label }), _jsx(Text, { size: "xs", color: "muted", children: REFUND_COPY.shipping.etaFormat(p.etaDaysMin, p.etaDaysMax) })] }), _jsx(Text, { size: "sm", weight: "semibold", children: fee === 0 ? REFUND_COPY.shipping.freeLabel : formatCurrency(fee / 100, "INR") })] }) }, p.providerId));
+        }) }));
+}

package/dist/features/cart/components/index.d.ts

@@ -1,6 +1,6 @@
 export { CartItemRow, CartDrawer } from "./CartDrawer";
 export { CartView } from "./CartView";
-export type { CartViewProps } from "./CartView";
+export type { CartViewProps, CartOrderGroup } from "./CartView";
 export { CartSummary } from "./CartSummary";
 export type { CartSummaryProps } from "./CartSummary";
 export { CheckoutView } from "./CheckoutView";
@@ -11,3 +11,5 @@ export { CheckoutOtpModal } from "./CheckoutOtpModal";
 export type { CheckoutOtpModalProps } from "./CheckoutOtpModal";
 export { CheckoutSuccessView } from "./CheckoutSuccessView";
 export type { CheckoutSuccessViewProps } from "./CheckoutSuccessView";
+export { ShippingPicker } from "./ShippingPicker";
+export type { ShippingPickerProps } from "./ShippingPicker";

package/dist/features/cart/components/index.js

@@ -5,3 +5,4 @@ export { CheckoutView } from "./CheckoutView";
 export { CheckoutAddressStep } from "./CheckoutAddressStep";
 export { CheckoutOtpModal } from "./CheckoutOtpModal";
 export { CheckoutSuccessView } from "./CheckoutSuccessView";
+export { ShippingPicker } from "./ShippingPicker";

package/dist/features/cart/hooks/useCartCount.js

@@ -16,5 +16,11 @@ export function useCartCount(enabled = false) {
         queryFn: () => apiClient.get(CART_ENDPOINTS.GET),
         enabled,
     });
-    return data?.itemCount ?? guestCount;
+    // When authenticated, the server is authoritative — never mix in the guest
+    // count, otherwise stale localStorage entries leak into the badge after
+    // login (the cart-merge clears the local store but `useGuestCart`'s React
+    // state holds the pre-clear snapshot until remount).
+    if (enabled)
+        return data?.itemCount ?? 0;
+    return guestCount;
 }

package/dist/features/cart/repository/cart.repository.d.ts

@@ -16,6 +16,7 @@ export declare class CartRepository extends BaseRepository<CartDocument> {
     getSubtotal(cart: CartDocument): number;
     addCoupon(userId: string, coupon: CartAppliedCoupon): Promise<void>;
     removeCoupon(userId: string, code: string): Promise<void>;
+    updateItemShipping(userId: string, itemId: string, providerId: string, feeInPaise: number): Promise<CartDocument>;
     clearAllCoupons(userId: string): Promise<void>;
     setSelectedItems(userId: string, itemIds: string[] | null): Promise<void>;
     /**

package/dist/features/cart/repository/cart.repository.js

@@ -84,6 +84,13 @@ export class CartRepository extends BaseRepository {
                     ...(input.lockedPrice !== undefined && {
                         lockedPrice: input.lockedPrice,
                     }),
+                    // SB-UNI-4 2026-05-13 — propagate bundle identifiers when present.
+                    ...(input.bundleCategorySlug !== undefined && {
+                        bundleCategorySlug: input.bundleCategorySlug,
+                    }),
+                    ...(input.bundleProductIds !== undefined && {
+                        bundleProductIds: input.bundleProductIds,
+                    }),
                     addedAt: new Date(),
                     updatedAt: new Date(),
                 };
@@ -209,6 +216,34 @@ export class CartRepository extends BaseRepository {
             .doc(userId)
             .set({ appliedCoupons: updated, updatedAt: new Date() }, { merge: true });
     }
+    async updateItemShipping(userId, itemId, providerId, feeInPaise) {
+        try {
+            const cart = await this.findByUserId(userId);
+            if (!cart)
+                throw new NotFoundError("Cart not found");
+            const itemIndex = cart.items.findIndex((item) => item.itemId === itemId);
+            if (itemIndex < 0)
+                throw new NotFoundError("Cart item not found");
+            const items = [...cart.items];
+            items[itemIndex] = {
+                ...items[itemIndex],
+                chosenShippingProviderId: providerId,
+                chosenShippingFeeInPaise: feeInPaise,
+                updatedAt: new Date(),
+            };
+            const updatedCart = { ...cart, items, updatedAt: new Date() };
+            await this.db
+                .collection(this.collection)
+                .doc(userId)
+                .set(prepareForFirestore(updatedCart));
+            return updatedCart;
+        }
+        catch (error) {
+            if (error instanceof DatabaseError || error instanceof NotFoundError)
+                throw error;
+            throw new DatabaseError("Failed to update cart item shipping", error);
+        }
+    }
     async clearAllCoupons(userId) {
         await this.db
             .collection(this.collection)

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

@@ -21,12 +21,33 @@ export interface CartItemDocument {
      * carts) and cart-side UI badges. Replaces the legacy `isAuction`/`isPreOrder`
      * pair on the cart item.
      */
-    listingType: "standard" | "auction" | "pre-order" | "prize-draw";
+    listingType: "standard" | "auction" | "pre-order" | "prize-draw" | "classified" | "digital-code" | "live";
     /** True when item was added from an accepted Make-an-Offer */
     isOffer?: boolean;
     offerId?: string;
     /** Locked offer price — overrides normal product price at checkout */
     lockedPrice?: number;
+    /**
+     * SB-UNI-4 2026-05-13 — bundle identifier when this cart line represents a
+     * bundle (categoryType:"bundle" row on the categories collection). When set,
+     * `productId` points at the bundle category's id, `price` is the locked
+     * bundlePriceInPaise, and `bundleProductIds` snapshots the member product
+     * ids at add-to-cart time. Order-side fan-out into per-product OrderItem
+     * entries lands in S-SBUNI-5 (checkout-side stock decrement + per-store
+     * grouping); until then the foundation is here but BundleDetailView keeps
+     * the "Add to cart coming soon" notice up.
+     */
+    bundleCategorySlug?: string;
+    /** Snapshot of `bundle.bundleProductIds` at add-to-cart time. */
+    bundleProductIds?: string[];
+    /**
+     * S-SBUNI-RULES 2026-05-13 — buyer's chosen shipping provider for this
+     * item, snapshotted at cart time. Locked at checkout; the per-tab
+     * ShippingPicker writes this when the buyer selects a provider.
+     */
+    chosenShippingProviderId?: string;
+    /** Fee in paise for the chosen provider, snapshotted at cart time. */
+    chosenShippingFeeInPaise?: number;
     addedAt: Date;
     updatedAt: Date;
 }
@@ -89,10 +110,14 @@ export type AddToCartInput = {
     /** Store slug (= storeId = store.id) */
     storeId: string;
     storeName: string;
-    listingType: "standard" | "auction" | "pre-order" | "prize-draw";
+    listingType: "standard" | "auction" | "pre-order" | "prize-draw" | "classified" | "digital-code" | "live";
     isOffer?: boolean;
     offerId?: string;
     lockedPrice?: number;
+    /** SB-UNI-4 2026-05-13 — bundle identifier when the line is a bundle. */
+    bundleCategorySlug?: string;
+    /** Snapshot of bundle members at add-to-cart time. */
+    bundleProductIds?: string[];
 };
 export type UpdateCartItemInput = {
     quantity: number;

package/dist/features/categories/components/BundleAddToCartCta.d.ts

@@ -0,0 +1,16 @@
+export interface BundleAddToCartCtaProps {
+    /** Bundle slug — `categories/{bundle-...}` row. */
+    bundleSlug: string;
+    /** True when bundleStockStatus === "out_of_stock". Renders disabled CTA. */
+    outOfStock?: boolean;
+    /**
+     * Server-action callback. Returning successfully marks the toast as success;
+     * any thrown error surfaces inline + as an error toast. Typed as a generic
+     * async fn so consumers can wrap the underlying action however they like.
+     */
+    onAddToCart: (input: {
+        bundleSlug: string;
+        quantity: number;
+    }) => Promise<unknown>;
+}
+export declare function BundleAddToCartCta({ bundleSlug, outOfStock, onAddToCart, }: BundleAddToCartCtaProps): import("react/jsx-runtime").JSX.Element;

package/dist/features/categories/components/BundleAddToCartCta.js

@@ -0,0 +1,54 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * BundleAddToCartCta — S-SBUNI-5 2026-05-13.
+ *
+ * Client island for the bundle detail page CTA. Replaces the "coming soon"
+ * disabled-CTA notice from S-SBUNI-3 + S-SBUNI-4 now that the cart-line
+ * foundation + per-member stock decrement at checkout are wired.
+ *
+ * Receives the bundle slug + an `onAddToCart` callback (typically the
+ * `addBundleToCartAction` server action from the consumer app). Renders
+ * a qty input + Add button + inline error / toast feedback.
+ *
+ * Out-of-stock bundles render a disabled button with `ctaOutOfStock` text.
+ */
+import { useState, useCallback } from "react";
+import { Button, Input, Row, Stack, Text } from "../../../ui";
+import { useToast } from "../../../ui";
+import { BUNDLE_COPY } from "../../../_internal/shared/features/categories/bundle-copy";
+const MIN_QTY = 1;
+const MAX_QTY = 10;
+export function BundleAddToCartCta({ bundleSlug, outOfStock = false, onAddToCart, }) {
+    const { showToast } = useToast();
+    const [quantity, setQuantity] = useState(MIN_QTY);
+    const [submitting, setSubmitting] = useState(false);
+    const [error, setError] = useState(null);
+    const handleClick = useCallback(async () => {
+        setError(null);
+        setSubmitting(true);
+        try {
+            await onAddToCart({ bundleSlug, quantity });
+            showToast(BUNDLE_COPY.detail.ctaSuccess, "success");
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : BUNDLE_COPY.detail.ctaErrorFallback;
+            setError(message);
+            showToast(message, "error");
+        }
+        finally {
+            setSubmitting(false);
+        }
+    }, [bundleSlug, quantity, onAddToCart, showToast]);
+    if (outOfStock) {
+        return (_jsxs(Stack, { gap: "xs", "aria-live": "polite", children: [_jsx(Button, { variant: "primary", disabled: true, "aria-disabled": true, children: BUNDLE_COPY.detail.ctaOutOfStock }), _jsx(Text, { size: "xs", color: "muted", children: BUNDLE_COPY.detail.ctaHint })] }));
+    }
+    return (_jsxs(Stack, { gap: "sm", children: [_jsxs(Row, { gap: "sm", align: "center", className: "flex-wrap", children: [_jsxs(Stack, { gap: "xs", children: [_jsx(Text, { size: "xs", color: "muted", children: BUNDLE_COPY.detail.qtyLabel }), _jsx(Input, { type: "number", inputMode: "numeric", min: MIN_QTY, max: MAX_QTY, step: 1, value: String(quantity), "aria-label": BUNDLE_COPY.detail.qtyAriaLabel, onChange: (e) => {
+                                    const next = Number(e.target.value);
+                                    if (Number.isFinite(next)) {
+                                        setQuantity(Math.min(Math.max(MIN_QTY, Math.floor(next)), MAX_QTY));
+                                    }
+                                }, disabled: submitting, className: "w-20" })] }), _jsx(Button, { variant: "primary", onClick: handleClick, disabled: submitting, "aria-busy": submitting, children: submitting
+                            ? BUNDLE_COPY.detail.ctaAdding
+                            : BUNDLE_COPY.detail.ctaAddToCart })] }), error && (_jsx(Text, { size: "sm", color: "danger", role: "alert", children: error }))] }));
+}

package/dist/features/categories/components/BundleBuyNowCta.d.ts

@@ -0,0 +1,8 @@
+export interface BundleBuyNowCtaProps {
+    bundleSlug: string;
+    outOfStock?: boolean;
+    onBuyNow: (input: {
+        bundleSlug: string;
+    }) => Promise<unknown>;
+}
+export declare function BundleBuyNowCta({ bundleSlug, outOfStock, onBuyNow, }: BundleBuyNowCtaProps): import("react/jsx-runtime").JSX.Element;

package/dist/features/categories/components/BundleBuyNowCta.js

@@ -0,0 +1,37 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * BundleBuyNowCta — direct-checkout CTA for bundle detail pages.
+ *
+ * Replaces BundleAddToCartCta (deleted). Bundles bypass the cart and go
+ * straight to checkout via the `directBundleCheckoutAction` server action.
+ * No qty input — bundles are always qty=1 per checkout.
+ */
+import { useState, useCallback } from "react";
+import { Button, Stack, Text } from "../../../ui";
+import { useToast } from "../../../ui";
+import { BUNDLE_COPY } from "../../../_internal/shared/features/categories/bundle-copy";
+export function BundleBuyNowCta({ bundleSlug, outOfStock = false, onBuyNow, }) {
+    const { showToast } = useToast();
+    const [submitting, setSubmitting] = useState(false);
+    const [error, setError] = useState(null);
+    const handleClick = useCallback(async () => {
+        setError(null);
+        setSubmitting(true);
+        try {
+            await onBuyNow({ bundleSlug });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : BUNDLE_COPY.detail.ctaErrorFallback;
+            setError(message);
+            showToast(message, "error");
+        }
+        finally {
+            setSubmitting(false);
+        }
+    }, [bundleSlug, onBuyNow, showToast]);
+    if (outOfStock) {
+        return (_jsxs(Stack, { gap: "xs", "aria-live": "polite", children: [_jsx(Button, { variant: "primary", disabled: true, "aria-disabled": true, children: BUNDLE_COPY.detail.ctaOutOfStock }), _jsx(Text, { size: "xs", color: "muted", children: BUNDLE_COPY.detail.ctaHint })] }));
+    }
+    return (_jsxs(Stack, { gap: "sm", children: [_jsx(Button, { variant: "primary", onClick: handleClick, disabled: submitting, "aria-busy": submitting, children: submitting ? BUNDLE_COPY.detail.ctaAdding : BUNDLE_COPY.detail.ctaBuyNow }), error && (_jsx(Text, { size: "sm", color: "danger", role: "alert", children: error }))] }));
+}

package/dist/features/categories/components/BundleDetailView.d.ts

@@ -0,0 +1,22 @@
+/**
+ * BundleDetailView — public detail page for a bundle (categoryType:"bundle"
+ * row on the categories collection). Rebuilt in S-SBUNI-3 2026-05-13 after
+ * the SB-UNI-V deletion. Slot-shell pattern: parent passes the doc + the
+ * resolved product members; this view stays presentational.
+ *
+ * Members rendered as a simple grid of product cards (links to PDPs). The
+ * "Buy bundle" CTA + non-refundable consent modal are intentionally NOT
+ * wired yet — bundle add-to-cart needs the SB-UNI-3 carry-over cohort
+ * (cart line `{bundleCategorySlug, qty}` + N-line checkout expansion).
+ */
+import type { CategoryDocument } from "../schemas";
+import type { ProductDocument } from "../../products/schemas/firestore";
+export interface BundleDetailViewProps {
+    bundle: CategoryDocument;
+    members?: ProductDocument[];
+    /** Direct-checkout callback (S-SBUNI-RULES). When supplied, renders the "Buy now" CTA. */
+    onBuyNow?: (input: {
+        bundleSlug: string;
+    }) => Promise<unknown>;
+}
+export declare function BundleDetailView({ bundle, members, onBuyNow, }: BundleDetailViewProps): import("react/jsx-runtime").JSX.Element;

package/dist/features/categories/components/BundleDetailView.js

@@ -0,0 +1,31 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import Link from "next/link";
+import { Badge, Container, Div, Heading, Main, Row, Section, Stack, Text, } from "../../../ui";
+import { ROUTES } from "../../../next/routing/route-map";
+import { formatCurrency } from "../../../utils/number.formatter";
+import { BUNDLE_COPY, BUNDLE_STOCK_VARIANT, } from "../../../_internal/shared/features/categories/bundle-copy";
+import { BundleBuyNowCta } from "./BundleBuyNowCta";
+const STOCK_BADGE_TEXT = {
+    in_stock: BUNDLE_COPY.stockBadge.in_stock,
+    partial: BUNDLE_COPY.stockBadge.partial,
+    out_of_stock: BUNDLE_COPY.stockBadge.out_of_stock,
+};
+const PLACEHOLDER_EMOJI = "📦";
+export function BundleDetailView({ bundle, members = [], onBuyNow, }) {
+    const memberCount = members.length || bundle.bundleProductIds?.length || 0;
+    const stock = bundle.bundleStockStatus ?? "in_stock";
+    const cover = bundle.display?.coverImage;
+    const priceLabel = bundle.bundlePriceInPaise
+        ? formatCurrency(bundle.bundlePriceInPaise / 100, "INR")
+        : BUNDLE_COPY.detail.priceFallback;
+    return (_jsx(Main, { children: _jsx(Section, { className: "py-10", children: _jsx(Container, { size: "xl", children: _jsxs(Stack, { gap: "lg", children: [_jsxs(Row, { gap: "lg", align: "start", className: "flex-col md:flex-row", children: [_jsx(Div, { className: "aspect-video w-full overflow-hidden rounded-2xl bg-zinc-100 md:w-1/2 dark:bg-zinc-800", children: cover ? (
+                                    // eslint-disable-next-line @next/next/no-img-element, lir/no-raw-media-elements
+                                    _jsx("img", { src: cover, alt: bundle.name, className: "h-full w-full object-cover" })) : (_jsx(Div, { className: "flex h-full w-full items-center justify-center text-6xl", children: PLACEHOLDER_EMOJI })) }), _jsxs(Stack, { gap: "md", className: "flex-1", children: [_jsx(Heading, { level: 1, className: "text-3xl font-semibold text-zinc-900 dark:text-zinc-100", children: bundle.name }), _jsxs(Row, { gap: "sm", align: "center", children: [_jsx(Text, { size: "lg", weight: "bold", children: priceLabel }), _jsxs(Text, { size: "sm", color: "muted", children: ["\u00B7 ", BUNDLE_COPY.detail.itemCount(memberCount)] }), _jsx(Badge, { variant: BUNDLE_STOCK_VARIANT[stock], children: STOCK_BADGE_TEXT[stock] })] }), bundle.description && (_jsxs(Stack, { gap: "xs", children: [_jsx(Heading, { level: 2, className: "text-sm font-semibold text-[var(--appkit-color-text-muted)]", children: BUNDLE_COPY.detailDescriptionHeading }), _jsx(Text, { className: "whitespace-pre-line", children: bundle.description })] })), onBuyNow ? (_jsx(BundleBuyNowCta, { bundleSlug: bundle.slug, outOfStock: stock === "out_of_stock", onBuyNow: onBuyNow })) : (_jsxs(Div, { className: "rounded-xl border border-dashed border-zinc-300 bg-zinc-50 p-4 text-sm dark:border-zinc-700 dark:bg-zinc-900", "aria-live": "polite", children: [_jsx(Text, { weight: "semibold", className: "mb-1 block", children: BUNDLE_COPY.detail.ctaDisabled }), _jsx(Text, { size: "sm", color: "muted", children: BUNDLE_COPY.detail.ctaHint })] }))] })] }), _jsxs(Stack, { gap: "md", children: [_jsx(Heading, { level: 2, className: "text-xl font-semibold text-zinc-900 dark:text-zinc-100", children: BUNDLE_COPY.detailItemsHeading }), members.length === 0 ? (_jsx(Text, { color: "muted", children: BUNDLE_COPY.detail.emptyMembers })) : (_jsx(Div, { className: "grid grid-cols-2 gap-3 sm:grid-cols-3 lg:grid-cols-4", children: members.map((p) => (_jsx(BundleMemberCard, { product: p }, p.id))) }))] })] }) }) }) }));
+}
+function BundleMemberCard({ product }) {
+    const href = String(ROUTES.PUBLIC.PRODUCT_DETAIL?.(product.slug ?? product.id) ?? "#");
+    const cover = product.mainImage ?? product.images?.[0];
+    return (_jsxs(Link, { href: href, className: "group rounded-xl border border-zinc-200 bg-white p-2 transition-colors hover:border-zinc-300 dark:border-zinc-800 dark:bg-zinc-900 dark:hover:border-zinc-700", children: [_jsx(Div, { className: "mb-2 aspect-square overflow-hidden rounded-lg bg-zinc-100 dark:bg-zinc-800", children: cover ? (
+                // eslint-disable-next-line @next/next/no-img-element, lir/no-raw-media-elements
+                _jsx("img", { src: cover, alt: product.title, className: "h-full w-full object-cover transition-transform group-hover:scale-105", loading: "lazy" })) : (_jsx(Div, { className: "flex h-full w-full items-center justify-center text-3xl", children: PLACEHOLDER_EMOJI })) }), _jsx(Text, { className: "line-clamp-2 text-sm font-medium", children: product.title }), _jsx(Text, { size: "xs", color: "muted", className: "mt-1", children: formatCurrency((product.price ?? 0) / 100, product.currency ?? "INR") })] }));
+}

package/dist/features/categories/components/BundleDynamicRuleEditor.d.ts

@@ -0,0 +1,18 @@
+type DynamicRule = {
+    type: "dynamic";
+    filter: {
+        categorySlug?: string;
+        brandSlug?: string;
+        tags?: string[];
+        listingType?: "standard" | "pre-order";
+    };
+    orderBy?: "price-asc" | "price-desc" | "createdAt-desc";
+    limit: number;
+};
+export interface BundleDynamicRuleEditorProps {
+    value: DynamicRule | null;
+    onChange: (next: DynamicRule) => void;
+    disabled?: boolean;
+}
+export declare function BundleDynamicRuleEditor({ value, onChange, disabled, }: BundleDynamicRuleEditorProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/features/categories/components/BundleDynamicRuleEditor.js

@@ -0,0 +1,60 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * BundleDynamicRuleEditor — S-SBUNI-5 2026-05-13.
+ *
+ * Dynamic-rule companion to BundleItemsPicker. When an admin picks "dynamic"
+ * as the bundle's query-rule type, this view collects:
+ *   - filter: categorySlug? · brandSlug? · tags? · listingType?
+ *   - orderBy: price-asc | price-desc | createdAt-desc
+ *   - limit (1..BUNDLE_MAX_ITEMS)
+ *
+ * The resolved member ids are computed by the `onProductStockChange` Firebase
+ * Function + a scheduled job, cached on `bundleProductIds[]` with a
+ * `bundleQueryResolvedAt` timestamp. This editor only writes the rule.
+ */
+import { useCallback } from "react";
+import { Div, Input, Row, Select, Stack, Text } from "../../../ui";
+import { BUNDLE_MAX_ITEMS } from "../../../_internal/shared/features/categories/bundle-config";
+import { BUNDLE_COPY } from "../../../_internal/shared/features/categories/bundle-copy";
+const DEFAULT_DYNAMIC_RULE = {
+    type: "dynamic",
+    filter: {},
+    orderBy: "createdAt-desc",
+    limit: 6,
+};
+const ORDER_BY_OPTIONS = [
+    { label: "Newest first", value: "createdAt-desc" },
+    { label: "Price (low → high)", value: "price-asc" },
+    { label: "Price (high → low)", value: "price-desc" },
+];
+const LISTING_TYPE_OPTIONS = [
+    { label: "Any (standard + pre-order)", value: "" },
+    { label: "Standard only", value: "standard" },
+    { label: "Pre-order only", value: "pre-order" },
+];
+export function BundleDynamicRuleEditor({ value, onChange, disabled = false, }) {
+    const rule = value ?? DEFAULT_DYNAMIC_RULE;
+    const patch = useCallback((next) => onChange({ ...rule, ...next }), [rule, onChange]);
+    const patchFilter = useCallback((next) => onChange({ ...rule, filter: { ...rule.filter, ...next } }), [rule, onChange]);
+    const tagsValue = (rule.filter.tags ?? []).join(", ");
+    return (_jsxs(Stack, { gap: "md", children: [_jsxs(Row, { gap: "sm", align: "center", justify: "between", className: "flex-wrap", children: [_jsx(Text, { size: "sm", weight: "semibold", children: BUNDLE_COPY.adminEditor.dynamic.title }), _jsx(Text, { size: "xs", color: "muted", children: BUNDLE_COPY.adminEditor.dynamic.hint })] }), _jsxs(Div, { className: "grid grid-cols-1 gap-3 sm:grid-cols-2", children: [_jsxs(Stack, { gap: "xs", children: [_jsx(Text, { size: "xs", weight: "semibold", children: BUNDLE_COPY.adminEditor.dynamic.fields.categorySlug }), _jsx(Input, { type: "text", value: rule.filter.categorySlug ?? "", onChange: (e) => patchFilter({ categorySlug: e.target.value.trim() || undefined }), placeholder: "category-action-figures", disabled: disabled })] }), _jsxs(Stack, { gap: "xs", children: [_jsx(Text, { size: "xs", weight: "semibold", children: BUNDLE_COPY.adminEditor.dynamic.fields.brandSlug }), _jsx(Input, { type: "text", value: rule.filter.brandSlug ?? "", onChange: (e) => patchFilter({ brandSlug: e.target.value.trim() || undefined }), placeholder: "brand-bandai", disabled: disabled })] })] }), _jsxs(Stack, { gap: "xs", children: [_jsx(Text, { size: "xs", weight: "semibold", children: BUNDLE_COPY.adminEditor.dynamic.fields.tags }), _jsx(Input, { type: "text", value: tagsValue, onChange: (e) => {
+                            const parsed = e.target.value
+                                .split(",")
+                                .map((t) => t.trim())
+                                .filter(Boolean);
+                            patchFilter({ tags: parsed.length ? parsed : undefined });
+                        }, placeholder: "pokemon, starter-deck", disabled: disabled })] }), _jsxs(Div, { className: "grid grid-cols-1 gap-3 sm:grid-cols-3", children: [_jsxs(Stack, { gap: "xs", children: [_jsx(Text, { size: "xs", weight: "semibold", children: BUNDLE_COPY.adminEditor.dynamic.fields.listingType }), _jsx(Select, { options: LISTING_TYPE_OPTIONS, value: rule.filter.listingType ?? "", onValueChange: (next) => patchFilter({
+                                    listingType: next === "" ? undefined : next,
+                                }), disabled: disabled, "aria-label": BUNDLE_COPY.adminEditor.dynamic.fields.listingType })] }), _jsxs(Stack, { gap: "xs", children: [_jsx(Text, { size: "xs", weight: "semibold", children: BUNDLE_COPY.adminEditor.dynamic.fields.orderBy }), _jsx(Select, { options: ORDER_BY_OPTIONS.map((o) => ({
+                                    label: o.label,
+                                    value: o.value,
+                                })), value: (rule.orderBy ?? "createdAt-desc"), onValueChange: (next) => patch({ orderBy: next }), disabled: disabled, "aria-label": BUNDLE_COPY.adminEditor.dynamic.fields.orderBy })] }), _jsxs(Stack, { gap: "xs", children: [_jsx(Text, { size: "xs", weight: "semibold", children: BUNDLE_COPY.adminEditor.dynamic.fields.limit }), _jsx(Input, { type: "number", inputMode: "numeric", min: 1, max: BUNDLE_MAX_ITEMS, step: 1, value: String(rule.limit), onChange: (e) => {
+                                    const next = Number(e.target.value);
+                                    if (Number.isFinite(next)) {
+                                        patch({
+                                            limit: Math.min(Math.max(1, Math.floor(next)), BUNDLE_MAX_ITEMS),
+                                        });
+                                    }
+                                }, disabled: disabled })] })] })] }));
+}

package/dist/features/categories/components/BundleItemsPicker.d.ts

@@ -0,0 +1,26 @@
+export interface BundleItemSearchResult {
+    id: string;
+    title: string;
+    image?: string;
+    priceInPaise?: number;
+    storeId?: string;
+}
+export interface BundleItemsPickerProps {
+    /** Currently selected product ids. Source of truth lives in the parent form. */
+    value: string[];
+    /** Mutator called with the next ids list whenever a row is added or removed. */
+    onChange: (next: string[]) => void;
+    /** Async fetcher for search results. Receives debounced query. */
+    fetchProducts: (query: string) => Promise<BundleItemSearchResult[]>;
+    /** Optional override on min/max bounds (defaults to BUNDLE_MIN_ITEMS / BUNDLE_MAX_ITEMS). */
+    minItems?: number;
+    maxItems?: number;
+    /** Optional initial chip metadata so already-selected ids show titles, not raw ids. */
+    initialMetadata?: Record<string, BundleItemSearchResult>;
+}
+export declare function BundleItemsPicker({ value, onChange, fetchProducts, minItems, maxItems, initialMetadata, }: BundleItemsPickerProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Default fetcher hitting the public /api/products endpoint. Consumers can
+ * pass this directly to BundleItemsPicker's `fetchProducts` prop.
+ */
+export declare function defaultBundleItemsFetch(query: string): Promise<BundleItemSearchResult[]>;

package/dist/features/categories/components/BundleItemsPicker.js

@@ -0,0 +1,135 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * BundleItemsPicker — S-SBUNI-4 2026-05-13.
+ *
+ * Multi-select picker for bundle member products. Selected ids render as
+ * chips above the picker; a debounced search input queries the public
+ * /api/products endpoint and renders matches as checkbox rows. Enforces the
+ * BUNDLE_MIN_ITEMS / BUNDLE_MAX_ITEMS bounds at the UI level.
+ *
+ * The consumer passes a `fetchProducts(query)` prop so this component stays
+ * appkit-internal and the wire shape lives in the host app. A default
+ * implementation that hits `/api/products` is exported as
+ * `defaultBundleItemsFetch`.
+ */
+import { useCallback, useEffect, useMemo, useState } from "react";
+import { Badge, Button, Checkbox, Div, Input, Row, Stack, Text } from "../../../ui";
+import { BUNDLE_MAX_ITEMS, BUNDLE_MIN_ITEMS, } from "../../../_internal/shared/features/categories/bundle-config";
+import { BUNDLE_COPY } from "../../../_internal/shared/features/categories/bundle-copy";
+const SEARCH_DEBOUNCE_MS = 250;
+export function BundleItemsPicker({ value, onChange, fetchProducts, minItems = BUNDLE_MIN_ITEMS, maxItems = BUNDLE_MAX_ITEMS, initialMetadata = {}, }) {
+    const [query, setQuery] = useState("");
+    const [debouncedQuery, setDebouncedQuery] = useState("");
+    const [results, setResults] = useState([]);
+    const [isSearching, setIsSearching] = useState(false);
+    const [searchError, setSearchError] = useState(null);
+    const [metadata, setMetadata] = useState(initialMetadata);
+    // Debounce query
+    useEffect(() => {
+        const t = setTimeout(() => setDebouncedQuery(query.trim()), SEARCH_DEBOUNCE_MS);
+        return () => clearTimeout(t);
+    }, [query]);
+    // Fetch on debounced query change
+    useEffect(() => {
+        let cancelled = false;
+        if (debouncedQuery.length < 2) {
+            setResults([]);
+            setSearchError(null);
+            return;
+        }
+        setIsSearching(true);
+        setSearchError(null);
+        fetchProducts(debouncedQuery)
+            .then((rows) => {
+            if (cancelled)
+                return;
+            setResults(rows);
+            setMetadata((prev) => {
+                const next = { ...prev };
+                for (const r of rows)
+                    next[r.id] = r;
+                return next;
+            });
+        })
+            .catch((err) => {
+            if (cancelled)
+                return;
+            const msg = err instanceof Error ? err.message : "Search failed";
+            setSearchError(msg);
+            setResults([]);
+        })
+            .finally(() => {
+            if (!cancelled)
+                setIsSearching(false);
+        });
+        return () => {
+            cancelled = true;
+        };
+    }, [debouncedQuery, fetchProducts]);
+    const selectedSet = useMemo(() => new Set(value), [value]);
+    const toggle = useCallback((id) => {
+        if (selectedSet.has(id)) {
+            onChange(value.filter((v) => v !== id));
+            return;
+        }
+        if (value.length >= maxItems) {
+            return;
+        }
+        onChange([...value, id]);
+    }, [selectedSet, value, onChange, maxItems]);
+    const remove = useCallback((id) => onChange(value.filter((v) => v !== id)), [value, onChange]);
+    const tooFew = value.length < minItems;
+    const tooMany = value.length > maxItems;
+    const countLabel = BUNDLE_COPY.picker.selectedCount(value.length, minItems, maxItems);
+    const countVariant = tooFew || tooMany ? "warning" : "success";
+    return (_jsxs(Stack, { gap: "md", children: [_jsxs(Row, { gap: "sm", align: "center", justify: "between", className: "flex-wrap", children: [_jsx(Text, { size: "sm", weight: "semibold", children: BUNDLE_COPY.picker.title }), _jsx(Badge, { variant: countVariant, children: countLabel })] }), value.length > 0 && (_jsx(Div, { className: "flex flex-wrap gap-2 rounded-lg border border-zinc-200 bg-zinc-50 p-3 dark:border-zinc-700 dark:bg-zinc-900", children: value.map((id) => {
+                    const meta = metadata[id];
+                    const label = meta?.title ?? id;
+                    return (_jsxs(Row, { gap: "xs", align: "center", className: "rounded-full border border-zinc-300 bg-white px-3 py-1 text-xs dark:border-zinc-600 dark:bg-zinc-800", children: [_jsx(Text, { size: "xs", className: "max-w-[200px] truncate", children: label }), _jsx(Button, { variant: "ghost", size: "sm", "aria-label": BUNDLE_COPY.picker.removeAria(label), onClick: () => remove(id), children: "\u00D7" })] }, id));
+                }) })), _jsxs(Stack, { gap: "sm", children: [_jsx(Input, { type: "search", placeholder: BUNDLE_COPY.picker.searchPlaceholder, value: query, onChange: (e) => setQuery(e.target.value), "aria-label": BUNDLE_COPY.picker.searchAriaLabel }), searchError && (_jsx(Text, { size: "sm", color: "danger", children: searchError })), isSearching && (_jsx(Text, { size: "sm", color: "muted", children: BUNDLE_COPY.picker.searchingHint })), !isSearching &&
+                        debouncedQuery.length >= 2 &&
+                        results.length === 0 &&
+                        !searchError && (_jsx(Text, { size: "sm", color: "muted", children: BUNDLE_COPY.picker.noMatches(debouncedQuery) })), results.length > 0 && (_jsx(Div, { className: "max-h-72 overflow-y-auto rounded-lg border border-zinc-200 dark:border-zinc-700", children: results.map((r) => {
+                            const isSelected = selectedSet.has(r.id);
+                            const atCap = !isSelected && value.length >= maxItems;
+                            return (_jsxs(Row, { gap: "sm", align: "center", className: `border-b border-zinc-100 px-3 py-2 last:border-b-0 dark:border-zinc-800 ${isSelected ? "bg-blue-50 dark:bg-blue-950" : ""} ${atCap ? "opacity-50" : ""}`, children: [_jsx(Checkbox, { checked: isSelected, disabled: atCap, onChange: () => toggle(r.id), "aria-label": BUNDLE_COPY.picker.toggleAria(r.title) }), _jsxs(Stack, { gap: "xs", className: "flex-1", children: [_jsx(Text, { size: "sm", weight: "medium", children: r.title }), _jsxs(Row, { gap: "sm", children: [_jsx(Text, { size: "xs", color: "muted", children: r.id }), typeof r.priceInPaise === "number" && (_jsxs(Text, { size: "xs", color: "muted", children: ["\u00B7 \u20B9", Math.round(r.priceInPaise / 100).toLocaleString("en-IN")] }))] })] })] }, r.id));
+                        }) }))] })] }));
+}
+/**
+ * Default fetcher hitting the public /api/products endpoint. Consumers can
+ * pass this directly to BundleItemsPicker's `fetchProducts` prop.
+ */
+export async function defaultBundleItemsFetch(query) {
+    const url = `/api/products?q=${encodeURIComponent(query)}&pageSize=20`;
+    const res = await fetch(url, { method: "GET" });
+    if (!res.ok) {
+        throw new Error(`Search failed: ${res.status}`);
+    }
+    const data = (await res.json());
+    const rawItems = data?.data?.items ?? data?.items ?? [];
+    return rawItems
+        .map((r) => {
+        const rec = r;
+        const id = typeof rec.id === "string" ? rec.id : null;
+        const title = typeof rec.title === "string"
+            ? rec.title
+            : typeof rec.name === "string"
+                ? rec.name
+                : null;
+        if (!id || !title)
+            return null;
+        return {
+            id,
+            title,
+            image: typeof rec.mainImage === "string"
+                ? rec.mainImage
+                : Array.isArray(rec.images) && typeof rec.images[0] === "string"
+                    ? rec.images[0]
+                    : undefined,
+            priceInPaise: typeof rec.price === "number" ? rec.price : undefined,
+            storeId: typeof rec.storeId === "string" ? rec.storeId : undefined,
+        };
+    })
+        .filter((r) => r !== null);
+}

package/dist/features/categories/components/BundlesListView.d.ts

@@ -0,0 +1,13 @@
+type SearchParams = Record<string, string | string[]>;
+export interface BundlesListViewProps {
+    searchParams?: SearchParams;
+}
+/**
+ * Public `/bundles` index. Bundles live as `categoryType:"bundle"` rows on
+ * the categories collection (SB-UNI-D + V), so this fetches via
+ * `categoriesRepository.listByType("bundle", …)` instead of `productRepository`.
+ * Optional `?storeId=…` post-filters to a single seller's bundles.
+ * Sort UI is owned by `CategoryBundlesListing` (client).
+ */
+export declare function BundlesListView({ searchParams, }: BundlesListViewProps): Promise<import("react/jsx-runtime").JSX.Element>;
+export {};