@mohasinac/appkit 2.4.10 → 2.5.0

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

@@ -5,11 +5,12 @@ import Link from "next/link";
 import { ROUTES } from "../../../next";
 import { Row, Text } from "../../../ui";
 import { formatCurrency } from "../../../utils/number.formatter";
+import { isAuctionListing, isPreOrderListing } from "../utils/listing-type";
 function getHref(listing) {
     const slug = listing.slug ?? listing.id;
-    if (listing.isAuction)
+    if (isAuctionListing(listing))
         return String(ROUTES.PUBLIC.AUCTION_DETAIL(slug));
-    if (listing.isPreOrder)
+    if (isPreOrderListing(listing))
         return String(ROUTES.PUBLIC.PRE_ORDER_DETAIL(slug));
     return String(ROUTES.PUBLIC.PRODUCT_DETAIL(slug));
 }

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

@@ -5,7 +5,15 @@ export { InteractiveProductCard } from "./InteractiveProductCard";
 export type { InteractiveProductCardProps } from "./InteractiveProductCard";
 export { ProductForm, PRODUCT_STATUS_OPTIONS } from "./ProductForm";
 export type { ProductFormProps, ProductFormValue } from "./ProductForm";
+export { NonRefundableConsentModal } from "./NonRefundableConsentModal";
+export type { NonRefundableConsentModalProps, NonRefundableListingType, } from "./NonRefundableConsentModal";
+export { ProductFeaturesSelector } from "./ProductFeaturesSelector";
+export type { ProductFeaturesSelectorProps } from "./ProductFeaturesSelector";
 export { ProductFeatureBadges } from "./ProductFeatureBadges";
+export { FeatureBadge, FeatureBadgeList } from "./FeatureBadge";
+export type { FeatureBadgeProps, FeatureBadgeListProps, } from "./FeatureBadge";
+export { ProductFeaturesProvider, useProductFeatures, } from "./ProductFeaturesContext";
+export type { ProductFeaturesProviderProps } from "./ProductFeaturesContext";
 export { BuyBar } from "./BuyBar";
 export type { BuyBarProps } from "./BuyBar";
 export { ProductsView } from "./ProductsView";
@@ -49,3 +57,7 @@ export { SublistingCarouselSection } from "./SublistingCarouselSection";
 export { ShowGroupSection } from "./ShowGroupSection";
 export { GroupSettingsPanel } from "./GroupSettingsPanel";
 export type { GroupSettingsPanelProps } from "./GroupSettingsPanel";
+export { PrizeDrawsSection } from "./PrizeDrawsSection";
+export type { PrizeDrawsSectionProps } from "./PrizeDrawsSection";
+export { CompareOverlay } from "./CompareOverlay";
+export type { CompareOverlayProps, CompareOverlayLabels, CompareProductLike, } from "./CompareOverlay";

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

@@ -2,7 +2,11 @@ export { ProductCard, ProductGrid } from "./ProductGrid";
 export { ProductFilters, PRODUCT_FILTER_KEYS, PRODUCT_ADMIN_SORT_OPTIONS, PRODUCT_SELLER_SORT_OPTIONS, PRODUCT_PUBLIC_SORT_OPTIONS, getProductFilterKeys, getProductSortOptions, } from "./ProductFilters";
 export { InteractiveProductCard } from "./InteractiveProductCard";
 export { ProductForm, PRODUCT_STATUS_OPTIONS } from "./ProductForm";
+export { NonRefundableConsentModal } from "./NonRefundableConsentModal";
+export { ProductFeaturesSelector } from "./ProductFeaturesSelector";
 export { ProductFeatureBadges } from "./ProductFeatureBadges";
+export { FeatureBadge, FeatureBadgeList } from "./FeatureBadge";
+export { ProductFeaturesProvider, useProductFeatures, } from "./ProductFeaturesContext";
 export { BuyBar } from "./BuyBar";
 export { ProductsView } from "./ProductsView";
 export { AuctionsView } from "./AuctionsView";
@@ -27,3 +31,5 @@ export { SublistingCategorySelect } from "./SublistingCategorySelect";
 export { SublistingCarouselSection } from "./SublistingCarouselSection";
 export { ShowGroupSection } from "./ShowGroupSection";
 export { GroupSettingsPanel } from "./GroupSettingsPanel";
+export { PrizeDrawsSection } from "./PrizeDrawsSection";
+export { CompareOverlay } from "./CompareOverlay";

package/dist/features/products/constants/action-defs.d.ts

@@ -0,0 +1,209 @@
+/**
+ * action-defs.ts
+ *
+ * Single source of truth for ALL action IDs, labels, variants, and groupings
+ * used across the platform:
+ *
+ *   Product detail pages  — desktop action panel + mobile BuyBar
+ *   Listing pages         — BulkActionsBar selections
+ *   Table rows            — RowActionMenu items (admin / seller / user)
+ *   Form shells           — submit / cancel / save-draft / publish / delete
+ *   Dashboard quick bar   — top-level shortcut buttons per dashboard type
+ *
+ * Pure TypeScript — no React, no JSX, no callbacks.
+ * Consuming components resolve iconName → Lucide component, and supply onClick.
+ */
+export type ActionVariant = "primary" | "secondary" | "outline" | "ghost" | "danger" | "warning";
+export declare const ACTION_ID: {
+    readonly BUY_NOW: "buy-now";
+    readonly ADD_TO_CART: "add-to-cart";
+    readonly ADD_TO_WISHLIST: "add-to-wishlist";
+    readonly REMOVE_FROM_WISHLIST: "remove-from-wishlist";
+    readonly MAKE_OFFER: "make-offer";
+    readonly SHARE: "share";
+    readonly COMPARE: "compare";
+    readonly PLACE_BID: "place-bid";
+    readonly BUY_NOW_AUCTION: "buy-now-auction";
+    readonly WATCH_AUCTION: "watch-auction";
+    readonly RESERVE_NOW: "reserve-now";
+    readonly CANCEL_RESERVATION: "cancel-reservation";
+};
+export type ActionId = (typeof ACTION_ID)[keyof typeof ACTION_ID];
+export interface ActionMeta {
+    id: ActionId;
+    /** Display label for buttons and menu items */
+    label: string;
+    /** Button variant — maps to the design system's Button variant prop */
+    variant: ActionVariant;
+    /** Lucide icon name — consuming component resolves this to the React component */
+    iconName?: string;
+    /** When true, the action is hidden if the user is not authenticated */
+    requiresAuth?: boolean;
+}
+export declare const ACTION_META: Record<ActionId, ActionMeta>;
+export declare const DETAIL_ACTIONS: {
+    /** Standard product: buy, cart, wishlist, offer, share */
+    readonly product: readonly ["buy-now", "add-to-cart", "add-to-wishlist", "make-offer", "share"];
+    /** Auction: bid, buy-now, watch, share */
+    readonly auction: readonly ["place-bid", "buy-now-auction", "watch-auction", "share"];
+    /** Pre-order: reserve, wishlist, share */
+    readonly preorder: readonly ["reserve-now", "add-to-wishlist", "share"];
+};
+export declare const MOBILE_PRIMARY_ACTIONS: {
+    readonly product: readonly ["buy-now", "add-to-cart"];
+    readonly auction: readonly ["place-bid", "buy-now-auction"];
+    readonly preorder: readonly ["reserve-now"];
+};
+export declare const LISTING_BULK_ACTIONS: {
+    readonly products: readonly ["add-to-cart", "add-to-wishlist", "compare"];
+    readonly auctions: readonly ["watch-auction", "add-to-wishlist", "compare"];
+    readonly preorders: readonly ["add-to-cart", "add-to-wishlist", "compare"];
+    readonly stores: ActionId[];
+};
+/** Maximum number of items the Compare overlay (BK3) supports at once. */
+export declare const COMPARE_MAX_ITEMS = 4;
+export declare const ROW_ACTION_ID: {
+    readonly EDIT: "row-edit";
+    readonly VIEW: "row-view";
+    readonly DELETE: "row-delete";
+    readonly APPROVE: "row-approve";
+    readonly REJECT: "row-reject";
+    readonly SUSPEND: "row-suspend";
+    readonly RESTORE: "row-restore";
+    readonly MANAGE: "row-manage";
+    readonly DUPLICATE: "row-duplicate";
+    readonly EXPORT: "row-export";
+    readonly TRACK: "row-track";
+    readonly CANCEL: "row-cancel";
+    readonly REFUND: "row-refund";
+    readonly RESEND: "row-resend";
+    readonly REPLY: "row-reply";
+    readonly PUBLISH: "row-publish";
+    readonly ARCHIVE: "row-archive";
+};
+export type RowActionId = (typeof ROW_ACTION_ID)[keyof typeof ROW_ACTION_ID];
+export interface RowActionMeta {
+    id: RowActionId;
+    /** Menu item label */
+    label: string;
+    /** Lucide icon name */
+    iconName?: string;
+    /** When true, item renders in red (destructive) in RowActionMenu */
+    destructive?: boolean;
+    /** Adds a separator above this item in the dropdown */
+    separator?: boolean;
+}
+export declare const ROW_ACTION_META: Record<RowActionId, RowActionMeta>;
+export declare const ADMIN_ROW_ACTIONS: {
+    readonly users: readonly ["row-view", "row-edit", "row-suspend", "row-restore", "row-delete"];
+    readonly stores: readonly ["row-manage", "row-approve", "row-reject", "row-suspend", "row-delete"];
+    readonly products: readonly ["row-view", "row-edit", "row-publish", "row-archive", "row-delete"];
+    readonly orders: readonly ["row-view", "row-edit", "row-refund", "row-cancel"];
+    readonly reviews: readonly ["row-view", "row-approve", "row-reject", "row-delete"];
+    readonly events: readonly ["row-view", "row-edit", "row-archive", "row-delete"];
+    readonly payouts: readonly ["row-view", "row-approve", "row-reject"];
+    readonly coupons: readonly ["row-edit", "row-duplicate", "row-archive", "row-delete"];
+    readonly blog: readonly ["row-view", "row-edit", "row-publish", "row-archive", "row-delete"];
+    readonly faqs: readonly ["row-edit", "row-archive", "row-delete"];
+    readonly bids: readonly ["row-view", "row-cancel"];
+};
+export declare const SELLER_ROW_ACTIONS: {
+    readonly products: readonly ["row-view", "row-edit", "row-duplicate", "row-archive", "row-delete"];
+    readonly orders: readonly ["row-view", "row-edit", "row-track", "row-resend"];
+    readonly reviews: readonly ["row-view", "row-reply"];
+    readonly payouts: readonly ["row-view", "row-export"];
+    readonly coupons: readonly ["row-edit", "row-duplicate", "row-delete"];
+    readonly bids: readonly ["row-view"];
+    readonly addresses: readonly ["row-edit", "row-delete"];
+};
+export declare const USER_ROW_ACTIONS: {
+    readonly orders: readonly ["row-view", "row-track", "row-cancel"];
+    readonly addresses: readonly ["row-edit", "row-delete"];
+    readonly bids: readonly ["row-view", "row-cancel"];
+};
+export declare const FORM_ACTION_ID: {
+    readonly SUBMIT: "form-submit";
+    readonly CANCEL: "form-cancel";
+    readonly RESET: "form-reset";
+    readonly SAVE_DRAFT: "form-save-draft";
+    readonly PUBLISH: "form-publish";
+    readonly DELETE: "form-delete";
+    readonly DISCARD: "form-discard";
+};
+export type FormActionId = (typeof FORM_ACTION_ID)[keyof typeof FORM_ACTION_ID];
+export interface FormActionMeta {
+    id: FormActionId;
+    /** Default button label — callers may override via a `labels` prop */
+    label: string;
+    variant: ActionVariant;
+    /** HTML button type */
+    type: "submit" | "button" | "reset";
+    iconName?: string;
+    /** When true, the action is considered destructive (visual hint for callers) */
+    destructive?: boolean;
+}
+export declare const FORM_ACTION_META: Record<FormActionId, FormActionMeta>;
+/**
+ * Preset ordered action groups for common form footer layouts.
+ * Consumed by FormShell and DrawerFormFooter to determine which buttons render,
+ * in which order (left → right).
+ */
+export declare const FORM_FOOTER_PRESET: {
+    /** Standard edit drawer: Cancel | Save Changes */
+    readonly drawerEdit: readonly ["form-cancel", "form-submit"];
+    /** Edit drawer with delete: Delete | Cancel | Save Changes */
+    readonly drawerEditDelete: readonly ["form-delete", "form-cancel", "form-submit"];
+    /** Content editor (blog / product): Discard | Save Draft | Publish */
+    readonly contentEditor: readonly ["form-discard", "form-save-draft", "form-publish"];
+    /** Simple modal / dialog: Cancel | Submit */
+    readonly modalForm: readonly ["form-cancel", "form-submit"];
+    /** Settings page: Reset | Save Changes */
+    readonly settingsForm: readonly ["form-reset", "form-submit"];
+};
+export declare const DASHBOARD_QUICK_ACTION_ID: {
+    readonly ADMIN_ADD_PRODUCT: "dqa-admin-add-product";
+    readonly ADMIN_ADD_USER: "dqa-admin-add-user";
+    readonly ADMIN_ADD_STORE: "dqa-admin-add-store";
+    readonly ADMIN_ADD_COUPON: "dqa-admin-add-coupon";
+    readonly ADMIN_ADD_EVENT: "dqa-admin-add-event";
+    readonly ADMIN_ADD_BLOG: "dqa-admin-add-blog";
+    readonly ADMIN_ADD_FAQ: "dqa-admin-add-faq";
+    readonly ADMIN_SETTINGS: "dqa-admin-settings";
+    readonly SELLER_ADD_PRODUCT: "dqa-seller-add-product";
+    readonly SELLER_ADD_COUPON: "dqa-seller-add-coupon";
+    readonly SELLER_VIEW_ORDERS: "dqa-seller-view-orders";
+    readonly SELLER_PAYOUT_REQ: "dqa-seller-payout-request";
+    readonly SELLER_SETTINGS: "dqa-seller-settings";
+    readonly USER_VIEW_ORDERS: "dqa-user-view-orders";
+    readonly USER_VIEW_WISHLIST: "dqa-user-view-wishlist";
+    readonly USER_EDIT_PROFILE: "dqa-user-edit-profile";
+    readonly USER_ADD_ADDRESS: "dqa-user-add-address";
+};
+export type DashboardQuickActionId = (typeof DASHBOARD_QUICK_ACTION_ID)[keyof typeof DASHBOARD_QUICK_ACTION_ID];
+export interface DashboardQuickActionMeta {
+    id: DashboardQuickActionId;
+    label: string;
+    variant: ActionVariant;
+    iconName?: string;
+    /** ROUTES key path that the button navigates to — consuming component resolves */
+    routeKey?: string;
+}
+export declare const DASHBOARD_QUICK_ACTION_META: Record<DashboardQuickActionId, DashboardQuickActionMeta>;
+export declare const DASHBOARD_QUICK_ACTIONS: {
+    readonly admin: readonly ["dqa-admin-add-product", "dqa-admin-add-user", "dqa-admin-add-store", "dqa-admin-add-coupon", "dqa-admin-add-event", "dqa-admin-add-blog", "dqa-admin-settings"];
+    readonly seller: readonly ["dqa-seller-add-product", "dqa-seller-add-coupon", "dqa-seller-view-orders", "dqa-seller-payout-request", "dqa-seller-settings"];
+    readonly user: readonly ["dqa-user-view-orders", "dqa-user-view-wishlist", "dqa-user-edit-profile", "dqa-user-add-address"];
+};
+export declare const ADMIN_BULK_ACTIONS: {
+    readonly users: readonly ["row-suspend", "row-restore", "row-delete"];
+    readonly stores: readonly ["row-approve", "row-reject", "row-suspend"];
+    readonly products: readonly ["row-publish", "row-archive", "row-delete"];
+    readonly orders: readonly ["row-refund", "row-cancel"];
+    readonly reviews: readonly ["row-approve", "row-reject", "row-delete"];
+    readonly blog: readonly ["row-publish", "row-archive", "row-delete"];
+    readonly faqs: readonly ["row-archive", "row-delete"];
+};
+export declare const SELLER_BULK_ACTIONS: {
+    readonly products: readonly ["row-publish", "row-archive", "row-delete"];
+    readonly coupons: readonly ["row-archive", "row-delete"];
+};

package/dist/features/products/constants/action-defs.js

@@ -0,0 +1,270 @@
+/**
+ * action-defs.ts
+ *
+ * Single source of truth for ALL action IDs, labels, variants, and groupings
+ * used across the platform:
+ *
+ *   Product detail pages  — desktop action panel + mobile BuyBar
+ *   Listing pages         — BulkActionsBar selections
+ *   Table rows            — RowActionMenu items (admin / seller / user)
+ *   Form shells           — submit / cancel / save-draft / publish / delete
+ *   Dashboard quick bar   — top-level shortcut buttons per dashboard type
+ *
+ * Pure TypeScript — no React, no JSX, no callbacks.
+ * Consuming components resolve iconName → Lucide component, and supply onClick.
+ */
+// ─────────────────────────────────────────────────────────────────────────────
+// § 1  Product / listing actions
+//      Used by: detail pages, BulkActionsBar, BuyBar
+// ─────────────────────────────────────────────────────────────────────────────
+export const ACTION_ID = {
+    // Standard product
+    BUY_NOW: "buy-now",
+    ADD_TO_CART: "add-to-cart",
+    ADD_TO_WISHLIST: "add-to-wishlist",
+    REMOVE_FROM_WISHLIST: "remove-from-wishlist",
+    MAKE_OFFER: "make-offer",
+    SHARE: "share",
+    COMPARE: "compare",
+    // Auction
+    PLACE_BID: "place-bid",
+    BUY_NOW_AUCTION: "buy-now-auction",
+    WATCH_AUCTION: "watch-auction",
+    // Pre-order
+    RESERVE_NOW: "reserve-now",
+    CANCEL_RESERVATION: "cancel-reservation",
+};
+export const ACTION_META = {
+    [ACTION_ID.BUY_NOW]: { id: ACTION_ID.BUY_NOW, label: "Buy Now", variant: "primary" },
+    [ACTION_ID.ADD_TO_CART]: { id: ACTION_ID.ADD_TO_CART, label: "Add to Cart", variant: "secondary", iconName: "ShoppingCart" },
+    [ACTION_ID.ADD_TO_WISHLIST]: { id: ACTION_ID.ADD_TO_WISHLIST, label: "Add to Wishlist", variant: "ghost", iconName: "Heart" },
+    [ACTION_ID.REMOVE_FROM_WISHLIST]: { id: ACTION_ID.REMOVE_FROM_WISHLIST, label: "Remove from Wishlist", variant: "ghost", iconName: "HeartOff" },
+    [ACTION_ID.MAKE_OFFER]: { id: ACTION_ID.MAKE_OFFER, label: "Make an Offer", variant: "outline", iconName: "Tag", requiresAuth: true },
+    [ACTION_ID.SHARE]: { id: ACTION_ID.SHARE, label: "Share", variant: "ghost", iconName: "Share2" },
+    [ACTION_ID.COMPARE]: { id: ACTION_ID.COMPARE, label: "Compare", variant: "secondary", iconName: "Columns" },
+    [ACTION_ID.PLACE_BID]: { id: ACTION_ID.PLACE_BID, label: "Place Bid", variant: "primary", requiresAuth: true },
+    [ACTION_ID.BUY_NOW_AUCTION]: { id: ACTION_ID.BUY_NOW_AUCTION, label: "Buy Now", variant: "secondary", requiresAuth: true },
+    [ACTION_ID.WATCH_AUCTION]: { id: ACTION_ID.WATCH_AUCTION, label: "Watch", variant: "ghost", iconName: "Eye" },
+    [ACTION_ID.RESERVE_NOW]: { id: ACTION_ID.RESERVE_NOW, label: "Reserve Now", variant: "primary", requiresAuth: true },
+    [ACTION_ID.CANCEL_RESERVATION]: { id: ACTION_ID.CANCEL_RESERVATION, label: "Cancel Reservation", variant: "danger", iconName: "X", requiresAuth: true },
+};
+// Detail page action groups — ordered top-to-bottom in the right-hand panel
+export const DETAIL_ACTIONS = {
+    /** Standard product: buy, cart, wishlist, offer, share */
+    product: [ACTION_ID.BUY_NOW, ACTION_ID.ADD_TO_CART, ACTION_ID.ADD_TO_WISHLIST, ACTION_ID.MAKE_OFFER, ACTION_ID.SHARE],
+    /** Auction: bid, buy-now, watch, share */
+    auction: [ACTION_ID.PLACE_BID, ACTION_ID.BUY_NOW_AUCTION, ACTION_ID.WATCH_AUCTION, ACTION_ID.SHARE],
+    /** Pre-order: reserve, wishlist, share */
+    preorder: [ACTION_ID.RESERVE_NOW, ACTION_ID.ADD_TO_WISHLIST, ACTION_ID.SHARE],
+};
+// Mobile BuyBar — 1–2 primary CTAs only (limited horizontal space)
+export const MOBILE_PRIMARY_ACTIONS = {
+    product: [ACTION_ID.BUY_NOW, ACTION_ID.ADD_TO_CART],
+    auction: [ACTION_ID.PLACE_BID, ACTION_ID.BUY_NOW_AUCTION],
+    preorder: [ACTION_ID.RESERVE_NOW],
+};
+// Listing page bulk actions — shown in BulkActionsBar when items are selected
+export const LISTING_BULK_ACTIONS = {
+    products: [ACTION_ID.ADD_TO_CART, ACTION_ID.ADD_TO_WISHLIST, ACTION_ID.COMPARE],
+    auctions: [ACTION_ID.WATCH_AUCTION, ACTION_ID.ADD_TO_WISHLIST, ACTION_ID.COMPARE],
+    preorders: [ACTION_ID.ADD_TO_CART, ACTION_ID.ADD_TO_WISHLIST, ACTION_ID.COMPARE],
+    stores: [ACTION_ID.COMPARE],
+};
+/** Maximum number of items the Compare overlay (BK3) supports at once. */
+export const COMPARE_MAX_ITEMS = 4;
+// ─────────────────────────────────────────────────────────────────────────────
+// § 2  Row / table actions
+//      Used by: RowActionMenu in admin, seller, and user dashboard tables
+// ─────────────────────────────────────────────────────────────────────────────
+export const ROW_ACTION_ID = {
+    EDIT: "row-edit",
+    VIEW: "row-view",
+    DELETE: "row-delete",
+    APPROVE: "row-approve",
+    REJECT: "row-reject",
+    SUSPEND: "row-suspend",
+    RESTORE: "row-restore",
+    MANAGE: "row-manage",
+    DUPLICATE: "row-duplicate",
+    EXPORT: "row-export",
+    TRACK: "row-track",
+    CANCEL: "row-cancel",
+    REFUND: "row-refund",
+    RESEND: "row-resend",
+    REPLY: "row-reply",
+    PUBLISH: "row-publish",
+    ARCHIVE: "row-archive",
+};
+export const ROW_ACTION_META = {
+    [ROW_ACTION_ID.EDIT]: { id: ROW_ACTION_ID.EDIT, label: "Edit", iconName: "Pencil" },
+    [ROW_ACTION_ID.VIEW]: { id: ROW_ACTION_ID.VIEW, label: "View", iconName: "Eye" },
+    [ROW_ACTION_ID.DELETE]: { id: ROW_ACTION_ID.DELETE, label: "Delete", iconName: "Trash2", destructive: true, separator: true },
+    [ROW_ACTION_ID.APPROVE]: { id: ROW_ACTION_ID.APPROVE, label: "Approve", iconName: "Check" },
+    [ROW_ACTION_ID.REJECT]: { id: ROW_ACTION_ID.REJECT, label: "Reject", iconName: "X", destructive: true },
+    [ROW_ACTION_ID.SUSPEND]: { id: ROW_ACTION_ID.SUSPEND, label: "Suspend", iconName: "Ban", destructive: true, separator: true },
+    [ROW_ACTION_ID.RESTORE]: { id: ROW_ACTION_ID.RESTORE, label: "Restore", iconName: "RotateCcw" },
+    [ROW_ACTION_ID.MANAGE]: { id: ROW_ACTION_ID.MANAGE, label: "Manage", iconName: "Settings" },
+    [ROW_ACTION_ID.DUPLICATE]: { id: ROW_ACTION_ID.DUPLICATE, label: "Duplicate", iconName: "Copy" },
+    [ROW_ACTION_ID.EXPORT]: { id: ROW_ACTION_ID.EXPORT, label: "Export", iconName: "Download" },
+    [ROW_ACTION_ID.TRACK]: { id: ROW_ACTION_ID.TRACK, label: "Track Shipment", iconName: "Truck" },
+    [ROW_ACTION_ID.CANCEL]: { id: ROW_ACTION_ID.CANCEL, label: "Cancel", iconName: "X", destructive: true },
+    [ROW_ACTION_ID.REFUND]: { id: ROW_ACTION_ID.REFUND, label: "Refund", iconName: "RefreshCw", destructive: true, separator: true },
+    [ROW_ACTION_ID.RESEND]: { id: ROW_ACTION_ID.RESEND, label: "Resend", iconName: "Send" },
+    [ROW_ACTION_ID.REPLY]: { id: ROW_ACTION_ID.REPLY, label: "Reply", iconName: "MessageSquare" },
+    [ROW_ACTION_ID.PUBLISH]: { id: ROW_ACTION_ID.PUBLISH, label: "Publish", iconName: "Upload" },
+    [ROW_ACTION_ID.ARCHIVE]: { id: ROW_ACTION_ID.ARCHIVE, label: "Archive", iconName: "Archive", separator: true },
+};
+// Admin dashboard row action groups per entity type
+export const ADMIN_ROW_ACTIONS = {
+    users: [ROW_ACTION_ID.VIEW, ROW_ACTION_ID.EDIT, ROW_ACTION_ID.SUSPEND, ROW_ACTION_ID.RESTORE, ROW_ACTION_ID.DELETE],
+    stores: [ROW_ACTION_ID.MANAGE, ROW_ACTION_ID.APPROVE, ROW_ACTION_ID.REJECT, ROW_ACTION_ID.SUSPEND, ROW_ACTION_ID.DELETE],
+    products: [ROW_ACTION_ID.VIEW, ROW_ACTION_ID.EDIT, ROW_ACTION_ID.PUBLISH, ROW_ACTION_ID.ARCHIVE, ROW_ACTION_ID.DELETE],
+    orders: [ROW_ACTION_ID.VIEW, ROW_ACTION_ID.EDIT, ROW_ACTION_ID.REFUND, ROW_ACTION_ID.CANCEL],
+    reviews: [ROW_ACTION_ID.VIEW, ROW_ACTION_ID.APPROVE, ROW_ACTION_ID.REJECT, ROW_ACTION_ID.DELETE],
+    events: [ROW_ACTION_ID.VIEW, ROW_ACTION_ID.EDIT, ROW_ACTION_ID.ARCHIVE, ROW_ACTION_ID.DELETE],
+    payouts: [ROW_ACTION_ID.VIEW, ROW_ACTION_ID.APPROVE, ROW_ACTION_ID.REJECT],
+    coupons: [ROW_ACTION_ID.EDIT, ROW_ACTION_ID.DUPLICATE, ROW_ACTION_ID.ARCHIVE, ROW_ACTION_ID.DELETE],
+    blog: [ROW_ACTION_ID.VIEW, ROW_ACTION_ID.EDIT, ROW_ACTION_ID.PUBLISH, ROW_ACTION_ID.ARCHIVE, ROW_ACTION_ID.DELETE],
+    faqs: [ROW_ACTION_ID.EDIT, ROW_ACTION_ID.ARCHIVE, ROW_ACTION_ID.DELETE],
+    bids: [ROW_ACTION_ID.VIEW, ROW_ACTION_ID.CANCEL],
+};
+// Seller / Store dashboard row action groups per entity type
+export const SELLER_ROW_ACTIONS = {
+    products: [ROW_ACTION_ID.VIEW, ROW_ACTION_ID.EDIT, ROW_ACTION_ID.DUPLICATE, ROW_ACTION_ID.ARCHIVE, ROW_ACTION_ID.DELETE],
+    orders: [ROW_ACTION_ID.VIEW, ROW_ACTION_ID.EDIT, ROW_ACTION_ID.TRACK, ROW_ACTION_ID.RESEND],
+    reviews: [ROW_ACTION_ID.VIEW, ROW_ACTION_ID.REPLY],
+    payouts: [ROW_ACTION_ID.VIEW, ROW_ACTION_ID.EXPORT],
+    coupons: [ROW_ACTION_ID.EDIT, ROW_ACTION_ID.DUPLICATE, ROW_ACTION_ID.DELETE],
+    bids: [ROW_ACTION_ID.VIEW],
+    addresses: [ROW_ACTION_ID.EDIT, ROW_ACTION_ID.DELETE],
+};
+// User dashboard row action groups per entity type
+export const USER_ROW_ACTIONS = {
+    orders: [ROW_ACTION_ID.VIEW, ROW_ACTION_ID.TRACK, ROW_ACTION_ID.CANCEL],
+    addresses: [ROW_ACTION_ID.EDIT, ROW_ACTION_ID.DELETE],
+    bids: [ROW_ACTION_ID.VIEW, ROW_ACTION_ID.CANCEL],
+};
+// ─────────────────────────────────────────────────────────────────────────────
+// § 3  Form actions
+//      Used by: FormShell, DrawerFormFooter, SideModal forms, inline forms
+// ─────────────────────────────────────────────────────────────────────────────
+export const FORM_ACTION_ID = {
+    SUBMIT: "form-submit",
+    CANCEL: "form-cancel",
+    RESET: "form-reset",
+    SAVE_DRAFT: "form-save-draft",
+    PUBLISH: "form-publish",
+    DELETE: "form-delete",
+    DISCARD: "form-discard",
+};
+export const FORM_ACTION_META = {
+    [FORM_ACTION_ID.SUBMIT]: { id: FORM_ACTION_ID.SUBMIT, label: "Save Changes", variant: "primary", type: "submit" },
+    [FORM_ACTION_ID.CANCEL]: { id: FORM_ACTION_ID.CANCEL, label: "Cancel", variant: "outline", type: "button" },
+    [FORM_ACTION_ID.RESET]: { id: FORM_ACTION_ID.RESET, label: "Reset", variant: "ghost", type: "reset" },
+    [FORM_ACTION_ID.SAVE_DRAFT]: { id: FORM_ACTION_ID.SAVE_DRAFT, label: "Save Draft", variant: "outline", type: "button", iconName: "Save" },
+    [FORM_ACTION_ID.PUBLISH]: { id: FORM_ACTION_ID.PUBLISH, label: "Publish", variant: "primary", type: "button", iconName: "Upload" },
+    [FORM_ACTION_ID.DELETE]: { id: FORM_ACTION_ID.DELETE, label: "Delete", variant: "danger", type: "button", iconName: "Trash2", destructive: true },
+    [FORM_ACTION_ID.DISCARD]: { id: FORM_ACTION_ID.DISCARD, label: "Discard", variant: "ghost", type: "button", destructive: true },
+};
+/**
+ * Preset ordered action groups for common form footer layouts.
+ * Consumed by FormShell and DrawerFormFooter to determine which buttons render,
+ * in which order (left → right).
+ */
+export const FORM_FOOTER_PRESET = {
+    /** Standard edit drawer: Cancel | Save Changes */
+    drawerEdit: [FORM_ACTION_ID.CANCEL, FORM_ACTION_ID.SUBMIT],
+    /** Edit drawer with delete: Delete | Cancel | Save Changes */
+    drawerEditDelete: [FORM_ACTION_ID.DELETE, FORM_ACTION_ID.CANCEL, FORM_ACTION_ID.SUBMIT],
+    /** Content editor (blog / product): Discard | Save Draft | Publish */
+    contentEditor: [FORM_ACTION_ID.DISCARD, FORM_ACTION_ID.SAVE_DRAFT, FORM_ACTION_ID.PUBLISH],
+    /** Simple modal / dialog: Cancel | Submit */
+    modalForm: [FORM_ACTION_ID.CANCEL, FORM_ACTION_ID.SUBMIT],
+    /** Settings page: Reset | Save Changes */
+    settingsForm: [FORM_ACTION_ID.RESET, FORM_ACTION_ID.SUBMIT],
+};
+// ─────────────────────────────────────────────────────────────────────────────
+// § 4  Dashboard quick actions
+//      Top-of-page shortcut buttons, one group per dashboard context
+// ─────────────────────────────────────────────────────────────────────────────
+export const DASHBOARD_QUICK_ACTION_ID = {
+    // Admin
+    ADMIN_ADD_PRODUCT: "dqa-admin-add-product",
+    ADMIN_ADD_USER: "dqa-admin-add-user",
+    ADMIN_ADD_STORE: "dqa-admin-add-store",
+    ADMIN_ADD_COUPON: "dqa-admin-add-coupon",
+    ADMIN_ADD_EVENT: "dqa-admin-add-event",
+    ADMIN_ADD_BLOG: "dqa-admin-add-blog",
+    ADMIN_ADD_FAQ: "dqa-admin-add-faq",
+    ADMIN_SETTINGS: "dqa-admin-settings",
+    // Seller / Store
+    SELLER_ADD_PRODUCT: "dqa-seller-add-product",
+    SELLER_ADD_COUPON: "dqa-seller-add-coupon",
+    SELLER_VIEW_ORDERS: "dqa-seller-view-orders",
+    SELLER_PAYOUT_REQ: "dqa-seller-payout-request",
+    SELLER_SETTINGS: "dqa-seller-settings",
+    // User / Buyer
+    USER_VIEW_ORDERS: "dqa-user-view-orders",
+    USER_VIEW_WISHLIST: "dqa-user-view-wishlist",
+    USER_EDIT_PROFILE: "dqa-user-edit-profile",
+    USER_ADD_ADDRESS: "dqa-user-add-address",
+};
+export const DASHBOARD_QUICK_ACTION_META = {
+    [DASHBOARD_QUICK_ACTION_ID.ADMIN_ADD_PRODUCT]: { id: DASHBOARD_QUICK_ACTION_ID.ADMIN_ADD_PRODUCT, label: "Add Product", variant: "primary", iconName: "Plus" },
+    [DASHBOARD_QUICK_ACTION_ID.ADMIN_ADD_USER]: { id: DASHBOARD_QUICK_ACTION_ID.ADMIN_ADD_USER, label: "Add User", variant: "outline", iconName: "UserPlus" },
+    [DASHBOARD_QUICK_ACTION_ID.ADMIN_ADD_STORE]: { id: DASHBOARD_QUICK_ACTION_ID.ADMIN_ADD_STORE, label: "Add Store", variant: "outline", iconName: "Store" },
+    [DASHBOARD_QUICK_ACTION_ID.ADMIN_ADD_COUPON]: { id: DASHBOARD_QUICK_ACTION_ID.ADMIN_ADD_COUPON, label: "Add Coupon", variant: "outline", iconName: "Tag" },
+    [DASHBOARD_QUICK_ACTION_ID.ADMIN_ADD_EVENT]: { id: DASHBOARD_QUICK_ACTION_ID.ADMIN_ADD_EVENT, label: "Add Event", variant: "outline", iconName: "Calendar" },
+    [DASHBOARD_QUICK_ACTION_ID.ADMIN_ADD_BLOG]: { id: DASHBOARD_QUICK_ACTION_ID.ADMIN_ADD_BLOG, label: "New Post", variant: "outline", iconName: "FileText" },
+    [DASHBOARD_QUICK_ACTION_ID.ADMIN_ADD_FAQ]: { id: DASHBOARD_QUICK_ACTION_ID.ADMIN_ADD_FAQ, label: "Add FAQ", variant: "outline", iconName: "HelpCircle" },
+    [DASHBOARD_QUICK_ACTION_ID.ADMIN_SETTINGS]: { id: DASHBOARD_QUICK_ACTION_ID.ADMIN_SETTINGS, label: "Settings", variant: "ghost", iconName: "Settings" },
+    [DASHBOARD_QUICK_ACTION_ID.SELLER_ADD_PRODUCT]: { id: DASHBOARD_QUICK_ACTION_ID.SELLER_ADD_PRODUCT, label: "List a Product", variant: "primary", iconName: "Plus" },
+    [DASHBOARD_QUICK_ACTION_ID.SELLER_ADD_COUPON]: { id: DASHBOARD_QUICK_ACTION_ID.SELLER_ADD_COUPON, label: "New Coupon", variant: "outline", iconName: "Tag" },
+    [DASHBOARD_QUICK_ACTION_ID.SELLER_VIEW_ORDERS]: { id: DASHBOARD_QUICK_ACTION_ID.SELLER_VIEW_ORDERS, label: "Orders", variant: "outline", iconName: "ShoppingBag" },
+    [DASHBOARD_QUICK_ACTION_ID.SELLER_PAYOUT_REQ]: { id: DASHBOARD_QUICK_ACTION_ID.SELLER_PAYOUT_REQ, label: "Request Payout", variant: "outline", iconName: "Banknote" },
+    [DASHBOARD_QUICK_ACTION_ID.SELLER_SETTINGS]: { id: DASHBOARD_QUICK_ACTION_ID.SELLER_SETTINGS, label: "Store Settings", variant: "ghost", iconName: "Settings" },
+    [DASHBOARD_QUICK_ACTION_ID.USER_VIEW_ORDERS]: { id: DASHBOARD_QUICK_ACTION_ID.USER_VIEW_ORDERS, label: "My Orders", variant: "outline", iconName: "Package" },
+    [DASHBOARD_QUICK_ACTION_ID.USER_VIEW_WISHLIST]: { id: DASHBOARD_QUICK_ACTION_ID.USER_VIEW_WISHLIST, label: "Wishlist", variant: "outline", iconName: "Heart" },
+    [DASHBOARD_QUICK_ACTION_ID.USER_EDIT_PROFILE]: { id: DASHBOARD_QUICK_ACTION_ID.USER_EDIT_PROFILE, label: "Edit Profile", variant: "outline", iconName: "User" },
+    [DASHBOARD_QUICK_ACTION_ID.USER_ADD_ADDRESS]: { id: DASHBOARD_QUICK_ACTION_ID.USER_ADD_ADDRESS, label: "Add Address", variant: "outline", iconName: "MapPin" },
+};
+// Quick action groups — ordered left-to-right in the top shortcut bar
+export const DASHBOARD_QUICK_ACTIONS = {
+    admin: [
+        DASHBOARD_QUICK_ACTION_ID.ADMIN_ADD_PRODUCT,
+        DASHBOARD_QUICK_ACTION_ID.ADMIN_ADD_USER,
+        DASHBOARD_QUICK_ACTION_ID.ADMIN_ADD_STORE,
+        DASHBOARD_QUICK_ACTION_ID.ADMIN_ADD_COUPON,
+        DASHBOARD_QUICK_ACTION_ID.ADMIN_ADD_EVENT,
+        DASHBOARD_QUICK_ACTION_ID.ADMIN_ADD_BLOG,
+        DASHBOARD_QUICK_ACTION_ID.ADMIN_SETTINGS,
+    ],
+    seller: [
+        DASHBOARD_QUICK_ACTION_ID.SELLER_ADD_PRODUCT,
+        DASHBOARD_QUICK_ACTION_ID.SELLER_ADD_COUPON,
+        DASHBOARD_QUICK_ACTION_ID.SELLER_VIEW_ORDERS,
+        DASHBOARD_QUICK_ACTION_ID.SELLER_PAYOUT_REQ,
+        DASHBOARD_QUICK_ACTION_ID.SELLER_SETTINGS,
+    ],
+    user: [
+        DASHBOARD_QUICK_ACTION_ID.USER_VIEW_ORDERS,
+        DASHBOARD_QUICK_ACTION_ID.USER_VIEW_WISHLIST,
+        DASHBOARD_QUICK_ACTION_ID.USER_EDIT_PROFILE,
+        DASHBOARD_QUICK_ACTION_ID.USER_ADD_ADDRESS,
+    ],
+};
+// Admin bulk actions per listing entity — used in BulkActionsBar on admin tables
+export const ADMIN_BULK_ACTIONS = {
+    users: [ROW_ACTION_ID.SUSPEND, ROW_ACTION_ID.RESTORE, ROW_ACTION_ID.DELETE],
+    stores: [ROW_ACTION_ID.APPROVE, ROW_ACTION_ID.REJECT, ROW_ACTION_ID.SUSPEND],
+    products: [ROW_ACTION_ID.PUBLISH, ROW_ACTION_ID.ARCHIVE, ROW_ACTION_ID.DELETE],
+    orders: [ROW_ACTION_ID.REFUND, ROW_ACTION_ID.CANCEL],
+    reviews: [ROW_ACTION_ID.APPROVE, ROW_ACTION_ID.REJECT, ROW_ACTION_ID.DELETE],
+    blog: [ROW_ACTION_ID.PUBLISH, ROW_ACTION_ID.ARCHIVE, ROW_ACTION_ID.DELETE],
+    faqs: [ROW_ACTION_ID.ARCHIVE, ROW_ACTION_ID.DELETE],
+};
+// Seller bulk actions per listing entity
+export const SELLER_BULK_ACTIONS = {
+    products: [ROW_ACTION_ID.PUBLISH, ROW_ACTION_ID.ARCHIVE, ROW_ACTION_ID.DELETE],
+    coupons: [ROW_ACTION_ID.ARCHIVE, ROW_ACTION_ID.DELETE],
+};

package/dist/features/products/constants/product-features.constants.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Shared constants for productFeatures editors, selectors, and renderers (FI1–FI6).
+ *
+ * Centralising these here keeps the admin/store editor (AdminFeatureEditorView),
+ * the product-form selector (ProductFeaturesSelector), and the badge renderer
+ * (FeatureBadge) in lockstep when a new category/icon/colour token is added.
+ */
+import type { SelectOption } from "../../../ui/components/Select";
+import type { ProductFeatureCategory, ProductFeatureProductType, ProductFeatureScope } from "../schemas/product-features";
+export declare const PRODUCT_FEATURE_CATEGORY_OPTIONS: SelectOption<ProductFeatureCategory>[];
+export declare const PRODUCT_FEATURE_PRODUCT_TYPE_OPTIONS: SelectOption<ProductFeatureProductType>[];
+export declare const PRODUCT_FEATURE_SCOPE_OPTIONS: SelectOption<ProductFeatureScope>[];
+export declare const PRODUCT_FEATURE_ICON_COLOR_OPTIONS: SelectOption[];
+/** Default displayOrder for newly created features. */
+export declare const PRODUCT_FEATURE_DEFAULT_DISPLAY_ORDER = 100;
+/** Maximum badges rendered inline on a ProductCard before the "+N more" pill. */
+export declare const PRODUCT_FEATURE_CARD_MAX_VISIBLE = 3;
+/** React Query staleTime for the platform/store feature lookups. */
+export declare const PRODUCT_FEATURE_QUERY_STALE_MS = 60000;
+export declare const PRODUCT_FEATURE_SCOPE_TABS: Array<{
+    value: ProductFeatureScope;
+    label: string;
+}>;

package/dist/features/products/constants/product-features.constants.js

@@ -0,0 +1,50 @@
+/**
+ * Shared constants for productFeatures editors, selectors, and renderers (FI1–FI6).
+ *
+ * Centralising these here keeps the admin/store editor (AdminFeatureEditorView),
+ * the product-form selector (ProductFeaturesSelector), and the badge renderer
+ * (FeatureBadge) in lockstep when a new category/icon/colour token is added.
+ */
+// ---------------------------------------------------------------------------
+// Option lists (Select / pill-checkbox UIs)
+// ---------------------------------------------------------------------------
+export const PRODUCT_FEATURE_CATEGORY_OPTIONS = [
+    { value: "shipping", label: "Shipping" },
+    { value: "seller", label: "Seller" },
+    { value: "condition", label: "Condition" },
+    { value: "platform", label: "Platform" },
+    { value: "auction", label: "Auction" },
+    { value: "preorder", label: "Pre-order" },
+    { value: "custom", label: "Custom" },
+];
+export const PRODUCT_FEATURE_PRODUCT_TYPE_OPTIONS = [
+    { value: "all", label: "All product types" },
+    { value: "product", label: "Standard product" },
+    { value: "auction", label: "Auction" },
+    { value: "preorder", label: "Pre-order" },
+];
+export const PRODUCT_FEATURE_SCOPE_OPTIONS = [
+    { value: "platform", label: "Platform (all stores)" },
+    { value: "store", label: "Store-specific" },
+];
+export const PRODUCT_FEATURE_ICON_COLOR_OPTIONS = [
+    { value: "", label: "Neutral (default)" },
+    { value: "--appkit-color-primary", label: "Primary" },
+    { value: "--appkit-color-secondary", label: "Secondary" },
+];
+// ---------------------------------------------------------------------------
+// Defaults + UX tuning knobs
+// ---------------------------------------------------------------------------
+/** Default displayOrder for newly created features. */
+export const PRODUCT_FEATURE_DEFAULT_DISPLAY_ORDER = 100;
+/** Maximum badges rendered inline on a ProductCard before the "+N more" pill. */
+export const PRODUCT_FEATURE_CARD_MAX_VISIBLE = 3;
+/** React Query staleTime for the platform/store feature lookups. */
+export const PRODUCT_FEATURE_QUERY_STALE_MS = 60000;
+// ---------------------------------------------------------------------------
+// Filter / tab labels
+// ---------------------------------------------------------------------------
+export const PRODUCT_FEATURE_SCOPE_TABS = [
+    { value: "platform", label: "Platform" },
+    { value: "store", label: "Store Custom" },
+];

package/dist/features/products/hooks/useProducts.d.ts

@@ -28,6 +28,7 @@ export declare function useProducts<T extends ProductItem = ProductItem>(params?
     hasMore: boolean;
     isLoading: boolean;
     error: Error | null;
+    warning: string | undefined;
 };
 interface UseProductOptions<T extends ProductItem = ProductItem> {
     initialData?: ProductItem;