@mohasinac/appkit 4.14.0 → 4.16.0

package/dist/_internal/shared/actions/action-registry.js

@@ -65,7 +65,54 @@ export function actionLabel(def) {
 // flows can reference today.
 export const ACTIONS = {
     PRODUCT: {
+        /*
+         * The buyer-facing verbs below shipped long ago; the four CRUD entries
+         * here did not exist at all, so every "New listing" / "Edit" / "Delete"
+         * control in the seller and admin product surfaces was an inline action
+         * object outside the registry (Rule #7).
+         */
+        view: {
+            iconKey: "view",
+            id: "product.view",
+            label: "View",
+            ariaLabel: "View listing",
+            description: "Open the listing's public detail page.",
+            kind: "secondary",
+        },
+        create: {
+            iconKey: "create",
+            id: "product.create",
+            label: "New listing",
+            ariaLabel: "Create a new listing",
+            description: "Create a listing of any type.",
+            kind: "primary",
+            permissions: ["admin", "seller"],
+        },
+        edit: {
+            iconKey: "edit",
+            id: "product.edit",
+            label: "Edit",
+            ariaLabel: "Edit listing",
+            description: "Edit this listing.",
+            kind: "secondary",
+            permissions: ["admin", "seller"],
+        },
+        delete: {
+            iconKey: "delete",
+            id: "product.delete",
+            label: "Delete",
+            ariaLabel: "Delete listing",
+            description: "Permanently delete this listing.",
+            kind: "danger",
+            permissions: ["admin", "seller"],
+            confirmation: {
+                title: "Delete this listing?",
+                body: "This cannot be undone. Orders that already reference it keep their own copy of the title, price and image, so past orders stay readable.",
+                confirmLabel: "Delete listing",
+            },
+        },
         "add-to-cart": {
+            iconKey: "cart",
             id: "product.add-to-cart",
             label: "Add to cart",
             ariaLabel: "Add to cart",
@@ -74,6 +121,7 @@ export const ACTIONS = {
             listingTypeScope: ["standard", "pre-order", "prize-draw", "digital-code", "live"],
         },
         "buy-now": {
+            iconKey: "cart",
             id: "product.buy-now",
             label: "Buy now",
             description: "Skip cart and head straight to checkout for this listing.",
@@ -81,6 +129,7 @@ export const ACTIONS = {
             listingTypeScope: ["standard", "pre-order"],
         },
         "add-to-wishlist": {
+            iconKey: "wishlist",
             id: "product.add-to-wishlist",
             label: "Save",
             ariaLabel: "Add to wishlist",
@@ -88,6 +137,7 @@ export const ACTIONS = {
             kind: "ghost",
         },
         "remove-from-wishlist": {
+            iconKey: "wishlist",
             id: "product.remove-from-wishlist",
             label: "Saved",
             ariaLabel: "Remove from wishlist",
@@ -95,6 +145,7 @@ export const ACTIONS = {
             kind: "ghost",
         },
         "sync-wishlist-item": {
+            iconKey: "retry",
             id: "product.sync-wishlist-item",
             label: "Sync",
             ariaLabel: "Sync this wishlist item with the latest product data",
@@ -102,6 +153,7 @@ export const ACTIONS = {
             kind: "ghost",
         },
         "share": {
+            iconKey: "share",
             id: "product.share",
             label: "Share",
             ariaLabel: "Share this listing",
@@ -109,6 +161,7 @@ export const ACTIONS = {
             kind: "ghost",
         },
         "compare": {
+            iconKey: "analytics",
             id: "product.compare",
             label: "Compare",
             ariaLabel: "Add to comparison",
@@ -116,6 +169,7 @@ export const ACTIONS = {
             kind: "ghost",
         },
         "make-offer": {
+            iconKey: "message",
             id: "product.make-offer",
             label: "Make an offer",
             description: "Propose a price to the seller for a classified listing.",
@@ -125,6 +179,7 @@ export const ACTIONS = {
     },
     AUCTION: {
         "place-bid": {
+            iconKey: "bid",
             id: "auction.place-bid",
             label: "Place bid",
             description: "Submit a bid on an auction listing.",
@@ -132,6 +187,7 @@ export const ACTIONS = {
             listingTypeScope: ["auction"],
         },
         "buy-it-now": {
+            iconKey: "cart",
             id: "auction.buy-it-now",
             label: "Buy It Now",
             description: "Claim the listing at the buy-now price (SB-UNI-H). Offered while the auction is unsold, before its end date, and while the buy-now price still beats the standing bid. Places a bid at that price plus a 1h locked cart line — the auction stays live until the buyer pays.",
@@ -139,6 +195,7 @@ export const ACTIONS = {
             listingTypeScope: ["auction"],
         },
         "watch": {
+            iconKey: "view",
             id: "auction.watch",
             label: "Watch auction",
             ariaLabel: "Watch this auction",
@@ -147,6 +204,7 @@ export const ACTIONS = {
             listingTypeScope: ["auction"],
         },
         "unwatch": {
+            iconKey: "hide",
             id: "auction.unwatch",
             label: "Watching",
             ariaLabel: "Stop watching this auction",
@@ -157,6 +215,7 @@ export const ACTIONS = {
     },
     PRE_ORDER: {
         "add-to-cart": {
+            iconKey: "cart",
             id: "pre-order.add-to-cart",
             label: "Add to cart",
             description: "Add a pre-order listing to the cart for checkout.",
@@ -164,6 +223,7 @@ export const ACTIONS = {
             listingTypeScope: ["pre-order"],
         },
         "reserve-now": {
+            iconKey: "cart",
             id: "pre-order.reserve-now",
             label: "Reserve now",
             description: "Lock in a pre-order reservation for this listing.",
@@ -171,6 +231,7 @@ export const ACTIONS = {
             listingTypeScope: ["pre-order"],
         },
         "cancel-reservation": {
+            iconKey: "cancel",
             id: "pre-order.cancel-reservation",
             label: "Cancel reservation",
             description: "Cancel the buyer's pre-order reservation.",
@@ -186,6 +247,7 @@ export const ACTIONS = {
     },
     PRIZE_DRAW: {
         "buy-now": {
+            iconKey: "cart",
             id: "prize-draw.buy-now",
             label: "Buy now",
             description: "Purchase a prize-draw entry directly (buyout — skips cart, goes to checkout).",
@@ -193,6 +255,7 @@ export const ACTIONS = {
             listingTypeScope: ["prize-draw"],
         },
         "enter-draw": {
+            iconKey: "confirm",
             id: "prize-draw.enter-draw",
             label: "Enter draw",
             description: "Purchase an entry into the prize draw.",
@@ -200,6 +263,7 @@ export const ACTIONS = {
             listingTypeScope: ["prize-draw"],
         },
         "reveal-code": {
+            iconKey: "view",
             id: "prize-draw.reveal-code",
             label: "Reveal code",
             description: "Reveal the buyer's prize-draw redemption code.",
@@ -209,6 +273,7 @@ export const ACTIONS = {
     },
     CLASSIFIED: {
         "contact-seller": {
+            iconKey: "message",
             id: "classified.contact-seller",
             label: "Contact seller",
             description: "Open a conversations thread with the seller — classified flow (SB-UNI-M).",
@@ -218,6 +283,7 @@ export const ACTIONS = {
     },
     DIGITAL_CODE: {
         "claim-code": {
+            iconKey: "confirm",
             id: "digital-code.claim-code",
             label: "Claim code",
             description: "Purchase and immediately reveal a digital code.",
@@ -227,6 +293,7 @@ export const ACTIONS = {
     },
     LIVE: {
         "inquire": {
+            iconKey: "message",
             id: "live.inquire",
             label: "Inquire",
             description: "Open a conversation with the seller about a live-item listing.",
@@ -236,6 +303,7 @@ export const ACTIONS = {
     },
     BUNDLE: {
         "buy-now": {
+            iconKey: "cart",
             id: "bundle.buy-now",
             label: "Buy now",
             description: "Purchase a bundle directly (buyout — skips cart, goes to checkout).",
@@ -243,12 +311,198 @@ export const ACTIONS = {
             categoryTypeScope: ["bundle"],
         },
     },
-    GROUP: {},
-    CATEGORY: {},
-    BRAND: {},
-    SUBLISTING: {},
+    /*
+     * These four buckets were literally `{}` for months while their editors
+     * shipped and worked — every CRUD control on a category, brand, grouped
+     * listing or sub-listing was therefore an inline action object, which is
+     * exactly what Rule #7 exists to prevent.
+     *
+     * Every destructive entry carries a `confirmation`, without which the action
+     * fires immediately and irreversibly.
+     */
+    GROUP: {
+        view: {
+            iconKey: "view",
+            id: "group.view",
+            label: "View",
+            ariaLabel: "View grouped listing",
+            description: "Open the grouped listing detail page.",
+            kind: "secondary",
+        },
+        create: {
+            iconKey: "create",
+            id: "group.create",
+            label: "New grouped listing",
+            ariaLabel: "Create a new grouped listing",
+            description: "Create a new grouped listing.",
+            kind: "primary",
+            permissions: ["admin"],
+        },
+        edit: {
+            iconKey: "edit",
+            id: "group.edit",
+            label: "Edit",
+            ariaLabel: "Edit grouped listing",
+            description: "Edit this grouped listing.",
+            kind: "secondary",
+            permissions: ["admin"],
+        },
+        delete: {
+            iconKey: "delete",
+            id: "group.delete",
+            label: "Delete",
+            ariaLabel: "Delete grouped listing",
+            description: "Permanently delete this grouped listing.",
+            kind: "danger",
+            permissions: ["admin"],
+            confirmation: {
+                title: "Delete this grouped listing?",
+                body: "This cannot be undone. Member listings are not deleted — only the group that ties them together.",
+                confirmLabel: "Delete",
+            },
+        },
+    },
+    CATEGORY: {
+        view: {
+            iconKey: "view",
+            id: "category.view",
+            label: "View",
+            ariaLabel: "View category",
+            description: "Open the category detail page.",
+            kind: "secondary",
+            categoryTypeScope: ["category"],
+        },
+        create: {
+            iconKey: "create",
+            id: "category.create",
+            label: "New category",
+            ariaLabel: "Create a new category",
+            description: "Create a new category.",
+            kind: "primary",
+            permissions: ["admin"],
+            categoryTypeScope: ["category"],
+        },
+        edit: {
+            iconKey: "edit",
+            id: "category.edit",
+            label: "Edit",
+            ariaLabel: "Edit category",
+            description: "Edit this category.",
+            kind: "secondary",
+            permissions: ["admin"],
+            categoryTypeScope: ["category"],
+        },
+        delete: {
+            iconKey: "delete",
+            id: "category.delete",
+            label: "Delete",
+            ariaLabel: "Delete category",
+            description: "Permanently delete this category.",
+            kind: "danger",
+            permissions: ["admin"],
+            confirmation: {
+                title: "Delete this category?",
+                body: "This cannot be undone. Listings filed under it are not deleted, but they will no longer appear on this category page.",
+                confirmLabel: "Delete",
+            },
+            categoryTypeScope: ["category"],
+        },
+    },
+    BRAND: {
+        view: {
+            iconKey: "view",
+            id: "brand.view",
+            label: "View",
+            ariaLabel: "View brand",
+            description: "Open the brand detail page.",
+            kind: "secondary",
+            categoryTypeScope: ["brand"],
+        },
+        create: {
+            iconKey: "create",
+            id: "brand.create",
+            label: "New brand",
+            ariaLabel: "Create a new brand",
+            description: "Create a new brand.",
+            kind: "primary",
+            permissions: ["admin"],
+            categoryTypeScope: ["brand"],
+        },
+        edit: {
+            iconKey: "edit",
+            id: "brand.edit",
+            label: "Edit",
+            ariaLabel: "Edit brand",
+            description: "Edit this brand.",
+            kind: "secondary",
+            permissions: ["admin"],
+            categoryTypeScope: ["brand"],
+        },
+        delete: {
+            iconKey: "delete",
+            id: "brand.delete",
+            label: "Delete",
+            ariaLabel: "Delete brand",
+            description: "Permanently delete this brand.",
+            kind: "danger",
+            permissions: ["admin"],
+            confirmation: {
+                title: "Delete this brand?",
+                body: "This cannot be undone. Products keep their `brand` string, so they will be orphaned from every brand page until re-filed.",
+                confirmLabel: "Delete",
+            },
+            categoryTypeScope: ["brand"],
+        },
+    },
+    SUBLISTING: {
+        view: {
+            iconKey: "view",
+            id: "sublisting.view",
+            label: "View",
+            ariaLabel: "View sub-listing",
+            description: "Open the sub-listing detail page.",
+            kind: "secondary",
+            categoryTypeScope: ["sublisting"],
+        },
+        create: {
+            iconKey: "create",
+            id: "sublisting.create",
+            label: "New sub-listing",
+            ariaLabel: "Create a new sub-listing",
+            description: "Create a new sub-listing.",
+            kind: "primary",
+            permissions: ["admin"],
+            categoryTypeScope: ["sublisting"],
+        },
+        edit: {
+            iconKey: "edit",
+            id: "sublisting.edit",
+            label: "Edit",
+            ariaLabel: "Edit sub-listing",
+            description: "Edit this sub-listing.",
+            kind: "secondary",
+            permissions: ["admin"],
+            categoryTypeScope: ["sublisting"],
+        },
+        delete: {
+            iconKey: "delete",
+            id: "sublisting.delete",
+            label: "Delete",
+            ariaLabel: "Delete sub-listing",
+            description: "Permanently delete this sub-listing.",
+            kind: "danger",
+            permissions: ["admin"],
+            confirmation: {
+                title: "Delete this sub-listing?",
+                body: "This cannot be undone.",
+                confirmLabel: "Delete",
+            },
+            categoryTypeScope: ["sublisting"],
+        },
+    },
     STORE: {
         "follow": {
+            iconKey: "wishlist",
             id: "store.follow",
             label: "Follow",
             ariaLabel: "Follow this store",
@@ -256,6 +510,7 @@ export const ACTIONS = {
             kind: "secondary",
         },
         "unfollow": {
+            iconKey: "wishlist",
             id: "store.unfollow",
             label: "Following",
             ariaLabel: "Unfollow this store",
@@ -263,6 +518,7 @@ export const ACTIONS = {
             kind: "ghost",
         },
         "view-all": {
+            iconKey: "view",
             id: "store.view-all",
             label: "View all",
             ariaLabel: "View all listings from this store",
@@ -271,6 +527,7 @@ export const ACTIONS = {
         },
         // ── Offer management ─────────────────────────────────────────────────
         "accept-offer": {
+            iconKey: "approve",
             id: "store.accept-offer",
             label: "Accept",
             ariaLabel: "Accept this offer",
@@ -279,6 +536,7 @@ export const ACTIONS = {
             permissions: ["seller", "admin"],
         },
         "reject-offer": {
+            iconKey: "reject",
             id: "store.reject-offer",
             label: "Reject",
             ariaLabel: "Reject this offer",
@@ -293,6 +551,7 @@ export const ACTIONS = {
             },
         },
         "counter-offer": {
+            iconKey: "reply",
             id: "store.counter-offer",
             label: "Counter",
             ariaLabel: "Counter this offer",
@@ -302,6 +561,7 @@ export const ACTIONS = {
         },
         // ── Payout view ──────────────────────────────────────────────────────
         "view-payout": {
+            iconKey: "view",
             id: "store.view-payout",
             label: "View Details",
             ariaLabel: "View payout details",
@@ -310,6 +570,7 @@ export const ACTIONS = {
             permissions: ["seller", "admin"],
         },
         "export-payout": {
+            iconKey: "export",
             id: "store.export-payout",
             label: "Export",
             ariaLabel: "Export payout details",
@@ -318,6 +579,7 @@ export const ACTIONS = {
             permissions: ["seller", "admin"],
         },
         "set-payout-reminder": {
+            iconKey: "settings",
             id: "store.set-payout-reminder",
             label: "Remind Me",
             ariaLabel: "Toggle a follow-up reminder on this payout",
@@ -327,6 +589,7 @@ export const ACTIONS = {
         },
         // ── Review management ───────────────────────────────────────────────
         "reply-review": {
+            iconKey: "reply",
             id: "store.reply-review",
             label: "Reply",
             ariaLabel: "Reply to this review",
@@ -335,6 +598,7 @@ export const ACTIONS = {
             permissions: ["seller", "admin"],
         },
         "contest-review": {
+            iconKey: "report",
             id: "store.contest-review",
             label: "Contest",
             ariaLabel: "Contest this review",
@@ -343,6 +607,7 @@ export const ACTIONS = {
             permissions: ["seller", "admin"],
         },
         "buyer-feedback": {
+            iconKey: "message",
             id: "store.buyer-feedback",
             label: "Feedback",
             ariaLabel: "Send feedback to buyer",
@@ -352,6 +617,7 @@ export const ACTIONS = {
         },
         // ── WhatsApp integration ────────────────────────────────────────────
         "whatsapp-connect": {
+            iconKey: "link",
             id: "store.whatsapp-connect",
             label: "Save & Connect",
             ariaLabel: "Save WhatsApp credentials and connect",
@@ -360,6 +626,7 @@ export const ACTIONS = {
             permissions: ["seller", "admin"],
         },
         "whatsapp-catalog-sync": {
+            iconKey: "retry",
             id: "store.whatsapp-catalog-sync",
             label: "Push to WhatsApp",
             ariaLabel: "Sync products to WhatsApp catalog",
@@ -368,6 +635,7 @@ export const ACTIONS = {
             permissions: ["seller", "admin"],
         },
         "whatsapp-catalog-import": {
+            iconKey: "upload",
             id: "store.whatsapp-catalog-import",
             label: "Import from WhatsApp",
             ariaLabel: "Import products from WhatsApp catalog",
@@ -377,6 +645,7 @@ export const ACTIONS = {
         },
         // ── Google Reviews integration ──────────────────────────────────────
         "google-reviews-sync": {
+            iconKey: "retry",
             id: "store.google-reviews-sync",
             label: "Sync now",
             ariaLabel: "Sync Google Business reviews",
@@ -385,6 +654,7 @@ export const ACTIONS = {
             permissions: ["seller", "admin"],
         },
         "save-google-settings": {
+            iconKey: "save",
             id: "store.save-google-settings",
             label: "Save Settings",
             ariaLabel: "Save Google Business settings",
@@ -394,6 +664,7 @@ export const ACTIONS = {
         },
         // ── Refresh ─────────────────────────────────────────────────────────
         "refresh-offers": {
+            iconKey: "retry",
             id: "store.refresh-offers",
             label: "Refresh",
             ariaLabel: "Refresh offers list",
@@ -402,6 +673,7 @@ export const ACTIONS = {
             permissions: ["seller", "admin"],
         },
         "edit-listing": {
+            iconKey: "edit",
             id: "store.edit-listing",
             label: "Edit",
             ariaLabel: "Edit listing",
@@ -410,6 +682,7 @@ export const ACTIONS = {
             permissions: ["seller", "admin"],
         },
         "delete-listing": {
+            iconKey: "delete",
             id: "store.delete-listing",
             label: "Delete",
             ariaLabel: "Delete listing",
@@ -424,6 +697,7 @@ export const ACTIONS = {
             },
         },
         "publish-listing": {
+            iconKey: "save",
             id: "store.publish-listing",
             label: "Publish",
             description: "Make this listing visible to buyers.",
@@ -431,6 +705,7 @@ export const ACTIONS = {
             permissions: ["seller", "admin"],
         },
         "unpublish-listing": {
+            iconKey: "hide",
             id: "store.unpublish-listing",
             label: "Unpublish",
             description: "Hide this listing from buyers.",
@@ -438,6 +713,7 @@ export const ACTIONS = {
             permissions: ["seller", "admin"],
         },
         "mark-shipped": {
+            iconKey: "ship",
             id: "store.mark-shipped",
             label: "Mark as shipped",
             description: "Update an order status to shipped and enter tracking info.",
@@ -445,6 +721,7 @@ export const ACTIONS = {
             permissions: ["seller", "admin"],
         },
         "mark-installment-paid": {
+            iconKey: "confirm",
             id: "store.mark-installment-paid",
             label: "Mark installment paid",
             ariaLabel: "Mark this EMI installment as paid",
@@ -459,6 +736,7 @@ export const ACTIONS = {
             },
         },
         "request-payout": {
+            iconKey: "send",
             id: "store.request-payout",
             label: "Request payout",
             description: "Submit a payout request for available store earnings.",
@@ -466,6 +744,7 @@ export const ACTIONS = {
             permissions: ["seller"],
         },
         "save-changes": {
+            iconKey: "save",
             id: "store.save-changes",
             label: "Save changes",
             description: "Submit the store listing or settings form.",
@@ -473,6 +752,7 @@ export const ACTIONS = {
             permissions: ["seller", "admin"],
         },
         "print-labels": {
+            iconKey: "export",
             id: "store.print-labels",
             label: "Print Labels",
             ariaLabel: "Print inventory labels for selected products",
@@ -481,6 +761,7 @@ export const ACTIONS = {
             permissions: ["seller", "admin"],
         },
         "set-location": {
+            iconKey: "settings",
             id: "store.set-location",
             label: "Set Location",
             ariaLabel: "Set physical storage location for selected items",
@@ -489,6 +770,7 @@ export const ACTIONS = {
             permissions: ["seller", "admin"],
         },
         "print-packing-slips": {
+            iconKey: "export",
             id: "store.print-packing-slips",
             label: "Print Packing Slips",
             ariaLabel: "Print packing slips for selected orders",
@@ -497,6 +779,7 @@ export const ACTIONS = {
             permissions: ["seller", "admin"],
         },
         "open-print-center": {
+            iconKey: "view",
             id: "store.open-print-center",
             label: "Print Center",
             ariaLabel: "Open the Print & Label Center",
@@ -507,6 +790,7 @@ export const ACTIONS = {
         // SB-UNI-W follow-up (plan §7) — leaves for the 11 unwired store-dashboard
         // form/row CTAs identified by the W-3 sweep.
         "create-template": {
+            iconKey: "create",
             id: "store.create-template",
             label: "Create Template",
             ariaLabel: "Create a new product template",
@@ -515,6 +799,7 @@ export const ACTIONS = {
             permissions: ["seller", "admin"],
         },
         "update-template": {
+            iconKey: "edit",
             id: "store.update-template",
             label: "Save Changes",
             ariaLabel: "Save changes to template",
@@ -523,6 +808,7 @@ export const ACTIONS = {
             permissions: ["seller", "admin"],
         },
         "edit-template": {
+            iconKey: "edit",
             id: "store.edit-template",
             label: "Edit",
             ariaLabel: "Edit template",
@@ -531,6 +817,7 @@ export const ACTIONS = {
             permissions: ["seller", "admin"],
         },
         "delete-template": {
+            iconKey: "delete",
             id: "store.delete-template",
             label: "Delete",
             ariaLabel: "Delete template",
@@ -545,6 +832,7 @@ export const ACTIONS = {
             },
         },
         "create-bundle": {
+            iconKey: "create",
             id: "store.create-bundle",
             label: "Create Bundle",
             ariaLabel: "Create a new bundle",
@@ -553,6 +841,7 @@ export const ACTIONS = {
             permissions: ["seller", "admin"],
         },
         "create-feature": {
+            iconKey: "create",
             id: "store.create-feature",
             label: "Create Feature",
             ariaLabel: "Create a new product feature badge",
@@ -561,6 +850,7 @@ export const ACTIONS = {
             permissions: ["seller", "admin"],
         },
         "update-slug": {
+            iconKey: "edit",
             id: "store.update-slug",
             label: "Update Slug",
             ariaLabel: "Update store slug",
@@ -575,6 +865,7 @@ export const ACTIONS = {
             },
         },
         "delete-sublisting-category": {
+            iconKey: "delete",
             id: "store.delete-sublisting-category",
             label: "Delete",
             ariaLabel: "Delete sublisting category",
@@ -589,6 +880,7 @@ export const ACTIONS = {
             },
         },
         "cancel-form": {
+            iconKey: "cancel",
             id: "store.cancel-form",
             label: "Cancel",
             ariaLabel: "Cancel form and close",
@@ -596,6 +888,7 @@ export const ACTIONS = {
             kind: "ghost",
         },
         "new-template": {
+            iconKey: "create",
             id: "store.new-template",
             label: "+ New Template",
             ariaLabel: "Open the new-template drawer",
@@ -606,6 +899,7 @@ export const ACTIONS = {
     },
     BLOG: {
         "create-post": {
+            iconKey: "create",
             id: "blog.create-post",
             label: "New Post",
             ariaLabel: "Create a new blog post",
@@ -614,6 +908,7 @@ export const ACTIONS = {
             permissions: ["admin", "moderator"],
         },
         "edit-post": {
+            iconKey: "edit",
             id: "blog.edit-post",
             label: "Edit",
             ariaLabel: "Edit this blog post",
@@ -622,6 +917,7 @@ export const ACTIONS = {
             permissions: ["admin", "moderator"],
         },
         "delete-post": {
+            iconKey: "delete",
             id: "blog.delete-post",
             label: "Delete",
             ariaLabel: "Delete this blog post",
@@ -638,12 +934,14 @@ export const ACTIONS = {
     },
     EVENT: {
         "register": {
+            iconKey: "user",
             id: "event.register",
             label: "Register",
             description: "Register to participate in this event.",
             kind: "primary",
         },
         "cancel-registration": {
+            iconKey: "cancel",
             id: "event.cancel-registration",
             label: "Cancel registration",
             description: "Cancel participation in this event.",
@@ -658,6 +956,7 @@ export const ACTIONS = {
     },
     USER: {
         "cancel-order": {
+            iconKey: "cancel",
             id: "user.cancel-order",
             label: "Cancel Order",
             description: "Cancel a pending or confirmed order.",
@@ -670,6 +969,7 @@ export const ACTIONS = {
             },
         },
         "cancel-order-items": {
+            iconKey: "cancel",
             id: "user.cancel-order-items",
             label: "Cancel Selected Items",
             description: "Cancel a subset of items on a pending or confirmed order and continue with the rest.",
@@ -682,30 +982,35 @@ export const ACTIONS = {
             },
         },
         "request-return": {
+            iconKey: "restore",
             id: "user.request-return",
             label: "Request return",
             description: "Raise a return request for a delivered order.",
             kind: "secondary",
         },
         "save-settings": {
+            iconKey: "save",
             id: "user.save-settings",
             label: "Save changes",
             description: "Submit the user settings form.",
             kind: "primary",
         },
         "send-verification-email": {
+            iconKey: "send",
             id: "user.send-verification-email",
             label: "Send Verification Email",
             description: "Send a verification link to the new email address.",
             kind: "secondary",
         },
         "update-password": {
+            iconKey: "edit",
             id: "user.update-password",
             label: "Update Password",
             description: "Submit the change-password form.",
             kind: "secondary",
         },
         "delete-address": {
+            iconKey: "delete",
             id: "user.delete-address",
             label: "Delete address",
             ariaLabel: "Delete address",
@@ -719,6 +1024,7 @@ export const ACTIONS = {
             },
         },
         "set-default-address": {
+            iconKey: "confirm",
             id: "user.set-default-address",
             label: "Set as default",
             ariaLabel: "Set as default address",
@@ -727,6 +1033,7 @@ export const ACTIONS = {
         },
         // Plan §6 — wishlist bulk actions (sticky bulk-action toolbar leaves).
         "wishlist-bulk-remove": {
+            iconKey: "wishlist",
             id: "user.wishlist-bulk-remove",
             label: "Remove selected",
             ariaLabel: "Remove selected items from wishlist",
@@ -740,6 +1047,7 @@ export const ACTIONS = {
             },
         },
         "wishlist-bulk-move-to-cart": {
+            iconKey: "wishlist",
             id: "user.wishlist-bulk-move-to-cart",
             label: "Move to cart",
             ariaLabel: "Move selected items to cart",
@@ -747,6 +1055,7 @@ export const ACTIONS = {
             kind: "primary",
         },
         "clear-selection": {
+            iconKey: "delete",
             id: "user.clear-selection",
             label: "Deselect",
             ariaLabel: "Clear current selection",
@@ -760,9 +1069,10 @@ export const ACTIONS = {
             ariaLabel: "View order details",
             description: "Open the full details of this order.",
             kind: "ghost",
-            iconKey: "Eye",
+            iconKey: "view",
         },
         "track-order": {
+            iconKey: "ship",
             id: "user.track-order",
             label: "Track Order",
             ariaLabel: "Track your order shipment",
@@ -770,6 +1080,7 @@ export const ACTIONS = {
             kind: "ghost",
         },
         "reorder": {
+            iconKey: "order",
             id: "user.reorder",
             label: "Reorder",
             ariaLabel: "Reorder items from this order",
@@ -782,9 +1093,10 @@ export const ACTIONS = {
             ariaLabel: "Download order invoice",
             description: "Download a PDF invoice for this order.",
             kind: "ghost",
-            iconKey: "FileDown",
+            iconKey: "export",
         },
         "write-review": {
+            iconKey: "review",
             id: "user.write-review",
             label: "Write Review",
             ariaLabel: "Write a review for this order",
@@ -792,6 +1104,7 @@ export const ACTIONS = {
             kind: "secondary",
         },
         "refresh-offers": {
+            iconKey: "retry",
             id: "user.refresh-offers",
             label: "Refresh",
             ariaLabel: "Refresh offers",
@@ -800,6 +1113,7 @@ export const ACTIONS = {
         },
         // Plan §10 — claim-coupon wallet (won-coupon entry points & wallet leaves).
         "claim-coupon": {
+            iconKey: "confirm",
             id: "user.claim-coupon",
             label: "Claim Coupon",
             ariaLabel: "Claim this coupon to your wallet",
@@ -807,6 +1121,7 @@ export const ACTIONS = {
             kind: "primary",
         },
         "use-claimed-coupon": {
+            iconKey: "confirm",
             id: "user.use-claimed-coupon",
             label: "Apply at checkout",
             ariaLabel: "Apply this coupon at checkout",
@@ -814,6 +1129,7 @@ export const ACTIONS = {
             kind: "link",
         },
         "remove-claimed-coupon": {
+            iconKey: "delete",
             id: "user.remove-claimed-coupon",
             label: "Remove",
             ariaLabel: "Remove coupon from wallet",
@@ -823,6 +1139,7 @@ export const ACTIONS = {
     },
     SELLER: {
         "cancel-bid": {
+            iconKey: "cancel",
             id: "seller.cancel-bid",
             label: "Cancel selected",
             ariaLabel: "Cancel selected bids",
@@ -839,6 +1156,7 @@ export const ACTIONS = {
     },
     SHIPMENT: {
         "create": {
+            iconKey: "create",
             id: "shipment.create",
             label: "New Shipment",
             ariaLabel: "Create a new procurement shipment",
@@ -847,6 +1165,7 @@ export const ACTIONS = {
             permissions: ["admin"],
         },
         "mark-received": {
+            iconKey: "confirm",
             id: "shipment.mark-received",
             label: "Mark Received",
             ariaLabel: "Mark this shipment as received",
@@ -855,6 +1174,7 @@ export const ACTIONS = {
             permissions: ["admin"],
         },
         "unlink-item": {
+            iconKey: "link",
             id: "shipment.unlink-item",
             label: "Unlink",
             ariaLabel: "Unlink this item from its product",
@@ -863,6 +1183,7 @@ export const ACTIONS = {
             permissions: ["admin"],
         },
         "delete": {
+            iconKey: "delete",
             id: "shipment.delete",
             label: "Delete",
             ariaLabel: "Delete this shipment",
@@ -879,6 +1200,7 @@ export const ACTIONS = {
     },
     CATALOGUE: {
         "list-item": {
+            iconKey: "create",
             id: "catalogue.list-item",
             label: "List",
             ariaLabel: "List this catalogue item directly",
@@ -887,6 +1209,7 @@ export const ACTIONS = {
             permissions: ["seller", "admin"],
         },
         "submit-for-approval": {
+            iconKey: "send",
             id: "catalogue.submit-for-approval",
             label: "Request to sell",
             ariaLabel: "Request admin list this item on your behalf",
@@ -894,6 +1217,7 @@ export const ACTIONS = {
             kind: "secondary",
         },
         "unlink": {
+            iconKey: "link",
             id: "catalogue.unlink",
             label: "Unlink",
             ariaLabel: "Unlink this catalogue item from its product",
@@ -902,6 +1226,7 @@ export const ACTIONS = {
             permissions: ["admin"],
         },
         "delete": {
+            iconKey: "delete",
             id: "catalogue.delete",
             label: "Delete",
             ariaLabel: "Remove this catalogue item",
@@ -915,6 +1240,7 @@ export const ACTIONS = {
             },
         },
         "approve": {
+            iconKey: "approve",
             id: "catalogue.approve",
             label: "Approve",
             ariaLabel: "Approve this catalogue listing request",
@@ -923,6 +1249,7 @@ export const ACTIONS = {
             permissions: ["admin"],
         },
         "reject": {
+            iconKey: "reject",
             id: "catalogue.reject",
             label: "Reject",
             ariaLabel: "Reject this catalogue listing request",
@@ -940,6 +1267,7 @@ export const ACTIONS = {
     ADMIN: {
         // ── Product moderation ─────────────────────────────────────────────────
         "approve-product": {
+            iconKey: "approve",
             id: "admin.approve-product",
             label: "Approve",
             ariaLabel: "Approve listing",
@@ -948,6 +1276,7 @@ export const ACTIONS = {
             permissions: ["admin", "moderator"],
         },
         "reject-product": {
+            iconKey: "reject",
             id: "admin.reject-product",
             label: "Reject",
             ariaLabel: "Reject listing",
@@ -963,6 +1292,7 @@ export const ACTIONS = {
         },
         // ── User moderation ────────────────────────────────────────────────────
         "ban-user": {
+            iconKey: "ban",
             id: "admin.ban-user",
             label: "Ban user",
             ariaLabel: "Ban this user",
@@ -977,6 +1307,7 @@ export const ACTIONS = {
             },
         },
         "unban-user": {
+            iconKey: "restore",
             id: "admin.unban-user",
             label: "Lift ban",
             ariaLabel: "Lift ban on this user",
@@ -985,6 +1316,7 @@ export const ACTIONS = {
             permissions: ["admin"],
         },
         "bulk-suspend-users": {
+            iconKey: "ban",
             id: "admin.bulk-suspend-users",
             label: "Suspend selected",
             ariaLabel: "Suspend selected users",
@@ -999,6 +1331,7 @@ export const ACTIONS = {
             },
         },
         "bulk-restore-users": {
+            iconKey: "restore",
             id: "admin.bulk-restore-users",
             label: "Restore selected",
             ariaLabel: "Restore selected users",
@@ -1007,6 +1340,7 @@ export const ACTIONS = {
             permissions: ["admin"],
         },
         "bulk-delete-users": {
+            iconKey: "delete",
             id: "admin.bulk-delete-users",
             label: "Delete selected",
             ariaLabel: "Delete selected users",
@@ -1021,6 +1355,7 @@ export const ACTIONS = {
             },
         },
         "verify-payment": {
+            iconKey: "verify",
             id: "admin.verify-payment",
             label: "Verify Payment",
             ariaLabel: "Mark payment as received and verified",
@@ -1034,6 +1369,7 @@ export const ACTIONS = {
             },
         },
         "request-payment-reupload": {
+            iconKey: "upload",
             id: "admin.request-payment-reupload",
             label: "Request Re-upload",
             ariaLabel: "Ask the buyer to re-upload a corrected payment proof",
@@ -1047,6 +1383,7 @@ export const ACTIONS = {
             },
         },
         "reject-payment-fraud": {
+            iconKey: "reject",
             id: "admin.reject-payment-fraud",
             label: "Reject as Fraudulent",
             ariaLabel: "Reject this payment proof as fraudulent, cancel the order, and ban the account",
@@ -1061,6 +1398,7 @@ export const ACTIONS = {
             },
         },
         "verify-vendor": {
+            iconKey: "verify",
             id: "admin.verify-vendor",
             label: "Verify vendor",
             ariaLabel: "Grant verified-vendor status",
@@ -1069,6 +1407,7 @@ export const ACTIONS = {
             permissions: ["admin"],
         },
         "unverify-vendor": {
+            iconKey: "reject",
             id: "admin.unverify-vendor",
             label: "Remove verification",
             ariaLabel: "Revoke verified-vendor status",
@@ -1084,6 +1423,7 @@ export const ACTIONS = {
         },
         // ── Store moderation ───────────────────────────────────────────────────
         "verify-store": {
+            iconKey: "verify",
             id: "admin.verify-store",
             label: "Verify store",
             ariaLabel: "Verify this store",
@@ -1092,6 +1432,7 @@ export const ACTIONS = {
             permissions: ["admin"],
         },
         "suspend-store": {
+            iconKey: "ban",
             id: "admin.suspend-store",
             label: "Suspend store",
             ariaLabel: "Suspend this store",
@@ -1107,6 +1448,7 @@ export const ACTIONS = {
         },
         // ── Review moderation ──────────────────────────────────────────────────
         "approve-review": {
+            iconKey: "approve",
             id: "admin.approve-review",
             label: "Approve",
             ariaLabel: "Approve review",
@@ -1115,6 +1457,7 @@ export const ACTIONS = {
             permissions: ["admin", "moderator"],
         },
         "reject-review": {
+            iconKey: "reject",
             id: "admin.reject-review",
             label: "Reject",
             ariaLabel: "Reject review",
@@ -1130,6 +1473,7 @@ export const ACTIONS = {
         },
         // ── Return request moderation ──────────────────────────────────────────
         "approve-return": {
+            iconKey: "approve",
             id: "admin.approve-return",
             label: "Approve return",
             ariaLabel: "Approve return request",
@@ -1138,6 +1482,7 @@ export const ACTIONS = {
             permissions: ["admin", "moderator"],
         },
         "reject-return": {
+            iconKey: "reject",
             id: "admin.reject-return",
             label: "Reject return",
             ariaLabel: "Reject return request",
@@ -1153,6 +1498,7 @@ export const ACTIONS = {
         },
         // ── Payout management ──────────────────────────────────────────────────
         "calculate-payouts": {
+            iconKey: "analytics",
             id: "admin.calculate-payouts",
             label: "Calculate Payouts",
             ariaLabel: "Run the weekly payout eligibility calculation",
@@ -1161,6 +1507,7 @@ export const ACTIONS = {
             permissions: ["admin"],
         },
         "grant-payout": {
+            iconKey: "approve",
             id: "admin.grant-payout",
             label: "Approve payout",
             ariaLabel: "Approve payout request",
@@ -1169,6 +1516,7 @@ export const ACTIONS = {
             permissions: ["admin"],
         },
         "hold-payout": {
+            iconKey: "pause",
             id: "admin.hold-payout",
             label: "Hold payout",
             ariaLabel: "Put payout on hold",
@@ -1184,6 +1532,7 @@ export const ACTIONS = {
         },
         // ── Bundle management ──────────────────────────────────────────────────
         "rebuild-bundle": {
+            iconKey: "retry",
             id: "admin.rebuild-bundle",
             label: "Rebuild bundle",
             ariaLabel: "Trigger bundle stock rebuild",
@@ -1193,6 +1542,7 @@ export const ACTIONS = {
         },
         // ── Dev / system ───────────────────────────────────────────────────────
         "reset-seed-data": {
+            iconKey: "retry",
             id: "admin.reset-seed-data",
             label: "Reset seed data",
             ariaLabel: "Clear and re-seed Firestore",
@@ -1208,6 +1558,7 @@ export const ACTIONS = {
         },
         // ── Generic admin forms ────────────────────────────────────────────────
         "save-changes": {
+            iconKey: "save",
             id: "admin.save-changes",
             label: "Save changes",
             description: "Submit any admin editor form.",
@@ -1215,6 +1566,7 @@ export const ACTIONS = {
             permissions: ["admin", "moderator"],
         },
         "export-csv": {
+            iconKey: "export",
             id: "admin.export-csv",
             label: "Export CSV",
             ariaLabel: "Export data as CSV",
@@ -1224,6 +1576,7 @@ export const ACTIONS = {
         },
         // ── Order management ──────────────────────────────────────────────────
         "mark-shipped": {
+            iconKey: "ship",
             id: "admin.mark-shipped",
             label: "Mark as Shipped",
             ariaLabel: "Mark order as shipped",
@@ -1232,6 +1585,7 @@ export const ACTIONS = {
             permissions: ["admin", "moderator"],
         },
         "mark-delivered": {
+            iconKey: "ship",
             id: "admin.mark-delivered",
             label: "Mark as Delivered",
             ariaLabel: "Mark order as delivered",
@@ -1240,6 +1594,7 @@ export const ACTIONS = {
             permissions: ["admin", "moderator"],
         },
         "mark-installment-paid": {
+            iconKey: "confirm",
             id: "admin.mark-installment-paid",
             label: "Mark installment paid",
             ariaLabel: "Mark this EMI installment as paid",
@@ -1254,6 +1609,7 @@ export const ACTIONS = {
             },
         },
         "cancel-order": {
+            iconKey: "cancel",
             id: "admin.cancel-order",
             label: "Cancel Orders",
             ariaLabel: "Cancel selected orders",
@@ -1269,6 +1625,7 @@ export const ACTIONS = {
         },
         // ── Payout management (extended) ──────────────────────────────────────
         "mark-paid": {
+            iconKey: "confirm",
             id: "admin.mark-paid",
             label: "Mark Paid",
             ariaLabel: "Mark payout as paid",
@@ -1278,6 +1635,7 @@ export const ACTIONS = {
         },
         // ── Session management ────────────────────────────────────────────────
         "revoke-session": {
+            iconKey: "ban",
             id: "admin.revoke-session",
             label: "Revoke Sessions",
             ariaLabel: "Revoke selected sessions",
@@ -1293,6 +1651,7 @@ export const ACTIONS = {
         },
         // ── Notification management ───────────────────────────────────────────
         "mark-read": {
+            iconKey: "confirm",
             id: "admin.mark-read",
             label: "Mark Read",
             ariaLabel: "Mark selected notifications as read",
@@ -1301,6 +1660,7 @@ export const ACTIONS = {
             permissions: ["admin", "moderator"],
         },
         "delete-notification": {
+            iconKey: "delete",
             id: "admin.delete-notification",
             label: "Delete Notifications",
             ariaLabel: "Delete selected notifications",
@@ -1316,6 +1676,7 @@ export const ACTIONS = {
         },
         // ── Tester QA management ──────────────────────────────────────────────
         "mark-feedback-reviewed": {
+            iconKey: "confirm",
             id: "admin.mark-feedback-reviewed",
             label: "Mark Reviewed",
             ariaLabel: "Mark this tester feedback as reviewed",
@@ -1324,6 +1685,7 @@ export const ACTIONS = {
             permissions: ["admin"],
         },
         "export-tester-feedback": {
+            iconKey: "export",
             id: "admin.export-tester-feedback",
             label: "Download Report",
             ariaLabel: "Download tester feedback as a Markdown report",
@@ -1332,6 +1694,7 @@ export const ACTIONS = {
             permissions: ["admin"],
         },
         "export-event-entries": {
+            iconKey: "export",
             id: "admin.export-event-entries",
             label: "Download Report",
             ariaLabel: "Download this event's entries as a Markdown report",
@@ -1340,6 +1703,7 @@ export const ACTIONS = {
             permissions: ["admin"],
         },
         "create-checklist-item": {
+            iconKey: "create",
             id: "admin.create-checklist-item",
             label: "Add Test Case",
             ariaLabel: "Add a new tester checklist item",
@@ -1348,6 +1712,7 @@ export const ACTIONS = {
             permissions: ["admin"],
         },
         "edit-checklist-item": {
+            iconKey: "edit",
             id: "admin.edit-checklist-item",
             label: "Edit",
             ariaLabel: "Edit this tester checklist item",
@@ -1356,6 +1721,7 @@ export const ACTIONS = {
             permissions: ["admin"],
         },
         "delete-checklist-item": {
+            iconKey: "delete",
             id: "admin.delete-checklist-item",
             label: "Delete",
             ariaLabel: "Delete this tester checklist item",
@@ -1370,6 +1736,7 @@ export const ACTIONS = {
             },
         },
         "confirm-bug": {
+            iconKey: "confirm",
             id: "admin.confirm-bug",
             label: "Mark as Bug",
             ariaLabel: "Confirm this as a real bug and credit the reporting tester",
@@ -1384,6 +1751,7 @@ export const ACTIONS = {
             },
         },
         "reopen-checklist-item": {
+            iconKey: "restore",
             id: "admin.reopen-checklist-item",
             label: "Reopen as New Test Case",
             ariaLabel: "Reopen this fixed case as a new version for retest",
@@ -1398,6 +1766,7 @@ export const ACTIONS = {
             },
         },
         "resend-notification": {
+            iconKey: "send",
             id: "admin.resend-notification",
             label: "Resend",
             ariaLabel: "Resend this notification",
@@ -1407,6 +1776,7 @@ export const ACTIONS = {
         },
         // ── Blog management ───────────────────────────────────────────────────
         "publish-blog": {
+            iconKey: "save",
             id: "admin.publish-blog",
             label: "Publish Selected",
             ariaLabel: "Publish selected blog posts",
@@ -1415,6 +1785,7 @@ export const ACTIONS = {
             permissions: ["admin", "moderator"],
         },
         "draft-blog": {
+            iconKey: "edit",
             id: "admin.draft-blog",
             label: "Move to Draft",
             ariaLabel: "Move selected posts to draft",
@@ -1424,6 +1795,7 @@ export const ACTIONS = {
         },
         // ── Brand & category management ───────────────────────────────────────
         "edit-brand": {
+            iconKey: "edit",
             id: "admin.edit-brand",
             label: "Edit Brand",
             ariaLabel: "Edit this brand",
@@ -1432,6 +1804,7 @@ export const ACTIONS = {
             permissions: ["admin"],
         },
         "edit-category": {
+            iconKey: "edit",
             id: "admin.edit-category",
             label: "Edit Category",
             ariaLabel: "Edit this category",
@@ -1441,6 +1814,7 @@ export const ACTIONS = {
         },
         // ── Feature & prize-draw management ────────────────────────────────────
         "delete-feature": {
+            iconKey: "delete",
             id: "admin.delete-feature",
             label: "Delete Features",
             ariaLabel: "Delete selected features",
@@ -1455,6 +1829,7 @@ export const ACTIONS = {
             },
         },
         "delete-prize-draw": {
+            iconKey: "delete",
             id: "admin.delete-prize-draw",
             label: "Delete Prize Draws",
             ariaLabel: "Delete selected prize draws",
@@ -1470,6 +1845,7 @@ export const ACTIONS = {
         },
         // ── Product toggles ───────────────────────────────────────────────────
         "toggle-featured": {
+            iconKey: "review",
             id: "admin.toggle-featured",
             label: "Toggle Featured",
             ariaLabel: "Toggle featured status",
@@ -1478,6 +1854,7 @@ export const ACTIONS = {
             permissions: ["admin", "moderator"],
         },
         "toggle-promoted": {
+            iconKey: "analytics",
             id: "admin.toggle-promoted",
             label: "Toggle Promoted",
             ariaLabel: "Toggle promoted status",
@@ -1486,6 +1863,7 @@ export const ACTIONS = {
             permissions: ["admin"],
         },
         "toggle-on-sale": {
+            iconKey: "analytics",
             id: "admin.toggle-on-sale",
             label: "Toggle On Sale",
             ariaLabel: "Toggle on-sale status",
@@ -1495,6 +1873,7 @@ export const ACTIONS = {
         },
         // ── Bundle management ─────────────────────────────────────────────────
         "activate-bundle": {
+            iconKey: "resume",
             id: "admin.activate-bundle",
             label: "Activate",
             ariaLabel: "Activate selected bundles",
@@ -1503,6 +1882,7 @@ export const ACTIONS = {
             permissions: ["admin"],
         },
         "deactivate-bundle": {
+            iconKey: "pause",
             id: "admin.deactivate-bundle",
             label: "Deactivate",
             ariaLabel: "Deactivate selected bundles",
@@ -1511,6 +1891,7 @@ export const ACTIONS = {
             permissions: ["admin"],
         },
         "delete-bundle": {
+            iconKey: "delete",
             id: "admin.delete-bundle",
             label: "Delete",
             ariaLabel: "Delete selected bundles",
@@ -1526,6 +1907,7 @@ export const ACTIONS = {
         },
         // ── Store/User management (bulk) ──────────────────────────────────────
         "manage-store": {
+            iconKey: "settings",
             id: "admin.manage-store",
             label: "Manage Store",
             ariaLabel: "Manage this store",
@@ -1534,6 +1916,7 @@ export const ACTIONS = {
             permissions: ["admin"],
         },
         "manage-user": {
+            iconKey: "settings",
             id: "admin.manage-user",
             label: "Manage Selected",
             ariaLabel: "Manage selected users",
@@ -1543,6 +1926,7 @@ export const ACTIONS = {
         },
         // ── Carousel management ──────────────────────────────────────────────
         "edit-carousel": {
+            iconKey: "edit",
             id: "admin.edit-carousel",
             label: "Edit Slide",
             ariaLabel: "Edit carousel slide",
@@ -1551,6 +1935,7 @@ export const ACTIONS = {
             permissions: ["admin"],
         },
         "delete-carousel": {
+            iconKey: "delete",
             id: "admin.delete-carousel",
             label: "Delete Slides",
             ariaLabel: "Delete selected carousel slides",
@@ -1566,6 +1951,7 @@ export const ACTIONS = {
         },
         // ── Contact management ────────────────────────────────────────────────
         "mark-contact-read": {
+            iconKey: "confirm",
             id: "admin.mark-contact-read",
             label: "Mark Read",
             ariaLabel: "Mark selected messages as read",
@@ -1574,6 +1960,7 @@ export const ACTIONS = {
             permissions: ["admin", "moderator"],
         },
         "archive-contact": {
+            iconKey: "archive",
             id: "admin.archive-contact",
             label: "Archive Messages",
             ariaLabel: "Archive selected messages",
@@ -1582,6 +1969,7 @@ export const ACTIONS = {
             permissions: ["admin", "moderator"],
         },
         "delete-contact": {
+            iconKey: "delete",
             id: "admin.delete-contact",
             label: "Delete Messages",
             ariaLabel: "Delete selected messages",
@@ -1597,6 +1985,7 @@ export const ACTIONS = {
         },
         // ── Newsletter management ─────────────────────────────────────────────
         "unsubscribe-newsletter": {
+            iconKey: "email",
             id: "admin.unsubscribe-newsletter",
             label: "Unsubscribe",
             ariaLabel: "Unsubscribe selected subscribers",
@@ -1612,6 +2001,7 @@ export const ACTIONS = {
         },
         // ── Team management ───────────────────────────────────────────────────
         "edit-team-member": {
+            iconKey: "edit",
             id: "admin.edit-team-member",
             label: "Edit Permissions",
             ariaLabel: "Edit team member permissions",
@@ -1620,6 +2010,7 @@ export const ACTIONS = {
             permissions: ["admin"],
         },
         "remove-team-member": {
+            iconKey: "delete",
             id: "admin.remove-team-member",
             label: "Remove Members",
             ariaLabel: "Remove selected team members",
@@ -1635,6 +2026,7 @@ export const ACTIONS = {
         },
         // ── FAQ management ────────────────────────────────────────────────────
         "delete-faq": {
+            iconKey: "delete",
             id: "admin.delete-faq",
             label: "Delete FAQs",
             ariaLabel: "Delete selected FAQs",
@@ -1649,6 +2041,7 @@ export const ACTIONS = {
             },
         },
         "archive-faq": {
+            iconKey: "archive",
             id: "admin.archive-faq",
             label: "Archive FAQs",
             ariaLabel: "Archive selected FAQs",
@@ -1658,6 +2051,7 @@ export const ACTIONS = {
         },
         // ── Coupon management ─────────────────────────────────────────────────
         "delete-coupon": {
+            iconKey: "delete",
             id: "admin.delete-coupon",
             label: "Delete Coupons",
             ariaLabel: "Delete selected coupons",
@@ -1672,6 +2066,7 @@ export const ACTIONS = {
             },
         },
         "edit-coupon": {
+            iconKey: "edit",
             id: "admin.edit-coupon",
             label: "Edit Coupon",
             ariaLabel: "Edit this coupon",
@@ -1680,6 +2075,7 @@ export const ACTIONS = {
             permissions: ["admin"],
         },
         "duplicate-coupon": {
+            iconKey: "duplicate",
             id: "admin.duplicate-coupon",
             label: "Duplicate",
             ariaLabel: "Duplicate this coupon",
@@ -1689,6 +2085,7 @@ export const ACTIONS = {
         },
         // ── Navigation management ─────────────────────────────────────────────
         "edit-nav": {
+            iconKey: "edit",
             id: "admin.edit-nav",
             label: "Edit",
             ariaLabel: "Edit navigation item",
@@ -1697,6 +2094,7 @@ export const ACTIONS = {
             permissions: ["admin"],
         },
         "delete-nav": {
+            iconKey: "delete",
             id: "admin.delete-nav",
             label: "Delete Nav Items",
             ariaLabel: "Delete selected navigation items",
@@ -1712,6 +2110,7 @@ export const ACTIONS = {
         },
         // ── Sublisting category management ────────────────────────────────────
         "delete-sublisting-category": {
+            iconKey: "delete",
             id: "admin.delete-sublisting-category",
             label: "Delete Categories",
             ariaLabel: "Delete selected sublisting categories",
@@ -1727,6 +2126,7 @@ export const ACTIONS = {
         },
         // ── Scammer management ────────────────────────────────────────────────
         "verify-scammer": {
+            iconKey: "verify",
             id: "admin.verify-scammer",
             label: "Verify Report",
             ariaLabel: "Verify this scammer report",
@@ -1735,6 +2135,7 @@ export const ACTIONS = {
             permissions: ["admin", "moderator"],
         },
         "dismiss-scammer": {
+            iconKey: "reject",
             id: "admin.dismiss-scammer",
             label: "Dismiss",
             ariaLabel: "Dismiss this scammer report",
@@ -1743,6 +2144,7 @@ export const ACTIONS = {
             permissions: ["admin", "moderator"],
         },
         "delete-scammer": {
+            iconKey: "delete",
             id: "admin.delete-scammer",
             label: "Delete Reports",
             ariaLabel: "Delete selected scammer reports",
@@ -1758,6 +2160,7 @@ export const ACTIONS = {
         },
         // ── Support ticket management ──────────────────────────────────────────
         "view-ticket": {
+            iconKey: "view",
             id: "admin.view-ticket",
             label: "View Details",
             ariaLabel: "View support ticket details",
@@ -1766,6 +2169,7 @@ export const ACTIONS = {
             permissions: ["admin", "moderator"],
         },
         "close-ticket": {
+            iconKey: "cancel",
             id: "admin.close-ticket",
             label: "Close Tickets",
             ariaLabel: "Close selected tickets",
@@ -1774,6 +2178,7 @@ export const ACTIONS = {
             permissions: ["admin", "moderator"],
         },
         "escalate-ticket": {
+            iconKey: "report",
             id: "admin.escalate-ticket",
             label: "Escalate",
             ariaLabel: "Escalate this ticket",
@@ -1783,6 +2188,7 @@ export const ACTIONS = {
         },
         // ── Event entry management ────────────────────────────────────────────
         "approve-entry": {
+            iconKey: "approve",
             id: "admin.approve-entry",
             label: "Approve Entries",
             ariaLabel: "Approve selected event entries",
@@ -1791,6 +2197,7 @@ export const ACTIONS = {
             permissions: ["admin", "moderator"],
         },
         "reject-entry": {
+            iconKey: "reject",
             id: "admin.reject-entry",
             label: "Reject Entries",
             ariaLabel: "Reject selected event entries",
@@ -1806,6 +2213,7 @@ export const ACTIONS = {
         },
         // ── Event entry management (row-level) ──────────────────────────────
         "confirm-entry": {
+            iconKey: "confirm",
             id: "admin.confirm-entry",
             label: "Confirm",
             ariaLabel: "Confirm this event entry",
@@ -1814,6 +2222,7 @@ export const ACTIONS = {
             permissions: ["admin", "moderator"],
         },
         "waitlist-entry": {
+            iconKey: "pause",
             id: "admin.waitlist-entry",
             label: "Waitlist",
             ariaLabel: "Waitlist this event entry",
@@ -1822,6 +2231,7 @@ export const ACTIONS = {
             permissions: ["admin", "moderator"],
         },
         "cancel-entry": {
+            iconKey: "cancel",
             id: "admin.cancel-entry",
             label: "Cancel",
             ariaLabel: "Cancel this event entry",
@@ -1837,6 +2247,7 @@ export const ACTIONS = {
         },
         // ── Review management (row-level) ─────────────────────────────────
         "feature-review": {
+            iconKey: "review",
             id: "admin.feature-review",
             label: "Feature",
             ariaLabel: "Feature this review",
@@ -1845,6 +2256,7 @@ export const ACTIONS = {
             permissions: ["admin", "moderator"],
         },
         "unfeature-review": {
+            iconKey: "review",
             id: "admin.unfeature-review",
             label: "Unfeature",
             ariaLabel: "Unfeature this review",
@@ -1854,6 +2266,7 @@ export const ACTIONS = {
         },
         // ── Scammer management (row-level) ────────────────────────────────
         "review-scammer": {
+            iconKey: "review",
             id: "admin.review-scammer",
             label: "Review",
             ariaLabel: "Review this scammer report",
@@ -1863,6 +2276,7 @@ export const ACTIONS = {
         },
         // ── Bid management ────────────────────────────────────────────────────
         "cancel-bid": {
+            iconKey: "cancel",
             id: "admin.cancel-bid",
             label: "Cancel Selected",
             ariaLabel: "Cancel selected bids",
@@ -1877,12 +2291,15 @@ export const ACTIONS = {
             },
         },
         "cancel-offer": {
+            iconKey: "cancel",
             id: "admin.cancel-offer",
             label: "Cancel Offer",
             ariaLabel: "Cancel this offer",
             description: "Expire the offer, clear it from the buyer's cart, and notify them. Admin cannot accept or counter on a seller's behalf.",
             kind: "danger",
-            permissions: ["admin", "moderator"],
+            // Admin only. The route is ROLES_ADMIN_ONLY, so listing "moderator" here
+            // showed a moderator an action that could only ever return 403.
+            permissions: ["admin"],
             confirmation: {
                 title: "Cancel this offer?",
                 body: "The offer will be expired and removed from the buyer's cart, and they'll be notified. This cannot be undone — the buyer would need to make a new offer.",
@@ -1892,6 +2309,7 @@ export const ACTIONS = {
         },
         // ── Address ban management ─────────────────────────────────────────────
         "ban-address": {
+            iconKey: "ban",
             id: "admin.ban-address",
             label: "Ban Address",
             ariaLabel: "Ban this address",
@@ -1906,6 +2324,7 @@ export const ACTIONS = {
             },
         },
         "approve-unban": {
+            iconKey: "approve",
             id: "admin.approve-unban",
             label: "Approve Unban",
             ariaLabel: "Approve unban request",
@@ -1914,6 +2333,7 @@ export const ACTIONS = {
             permissions: ["admin"],
         },
         "reject-unban": {
+            iconKey: "reject",
             id: "admin.reject-unban",
             label: "Reject Unban",
             ariaLabel: "Reject unban request",
@@ -1923,6 +2343,7 @@ export const ACTIONS = {
         },
         // ── Payment method ban management ──────────────────────────────────────
         "ban-payment-method": {
+            iconKey: "ban",
             id: "admin.ban-payment-method",
             label: "Ban Payment Method",
             ariaLabel: "Ban this payment method",
@@ -1937,6 +2358,7 @@ export const ACTIONS = {
             },
         },
         "approve-payment-unban": {
+            iconKey: "approve",
             id: "admin.approve-payment-unban",
             label: "Approve Unban",
             ariaLabel: "Approve payment method unban",
@@ -1945,6 +2367,7 @@ export const ACTIONS = {
             permissions: ["admin"],
         },
         "reject-payment-unban": {
+            iconKey: "reject",
             id: "admin.reject-payment-unban",
             label: "Reject Unban",
             ariaLabel: "Reject payment method unban",
@@ -1955,6 +2378,7 @@ export const ACTIONS = {
     },
     CART: {
         "clear-cart": {
+            iconKey: "delete",
             id: "cart.clear",
             label: "Clear cart",
             description: "Remove every item from the buyer's cart.",
@@ -1967,6 +2391,7 @@ export const ACTIONS = {
             },
         },
         "remove-item": {
+            iconKey: "delete",
             id: "cart.remove-item",
             label: "Remove",
             ariaLabel: "Remove item from cart",
@@ -1974,12 +2399,14 @@ export const ACTIONS = {
             kind: "ghost",
         },
         "checkout": {
+            iconKey: "cart",
             id: "cart.checkout",
             label: "Proceed to checkout",
             description: "Navigate from the cart page to the checkout flow.",
             kind: "primary",
         },
         "continue-shopping": {
+            iconKey: "back",
             id: "cart.continue-shopping",
             label: "Continue shopping",
             description: "Navigate back from the cart to the product catalogue.",
@@ -1988,60 +2415,70 @@ export const ACTIONS = {
     },
     CHECKOUT: {
         "place-order": {
+            iconKey: "bid",
             id: "checkout.place-order",
             label: "Place order",
             description: "Submit the order with the chosen payment method.",
             kind: "primary",
         },
         "continue-to-verification": {
+            iconKey: "back",
             id: "checkout.continue-to-verification",
             label: "Continue",
             description: "Advance from address selection to the payment step.",
             kind: "primary",
         },
         "verify-otp": {
+            iconKey: "verify",
             id: "checkout.verify-otp",
             label: "Verify & Continue",
             description: "Submit the high-value-order one-time code and proceed to payment.",
             kind: "primary",
         },
         "resend-otp": {
+            iconKey: "send",
             id: "checkout.resend-otp",
             label: "Resend code",
             description: "Re-send the high-value-order verification code to the buyer's registered email.",
             kind: "ghost",
         },
         "pay-online": {
+            iconKey: "cart",
             id: "checkout.pay-online",
             label: "Pay Online (Razorpay)",
             description: "Initiate an online payment via Razorpay UPI/Card/NetBanking.",
             kind: "primary",
         },
         "pay-cod": {
+            iconKey: "cart",
             id: "checkout.pay-cod",
             label: "Cash on Delivery",
             description: "Place the order for cash-on-delivery payment.",
             kind: "secondary",
         },
         "admin-bypass": {
+            iconKey: "lock",
             id: "checkout.admin-bypass",
             label: "Skip Verification — Admin Bypass",
             description: "Admin test mode: skip identity verification and place a test order without payment.",
             kind: "secondary",
         },
         "admin-bypass-payment": {
+            iconKey: "lock",
             id: "checkout.admin-bypass-payment",
             label: "No Payment — Admin Bypass Order",
             description: "Admin test mode: place a real order record without charging any payment.",
             kind: "secondary",
         },
         "apply-coupon": {
+            iconKey: "confirm",
             id: "checkout.apply-coupon",
             label: "Apply coupon",
             description: "Validate and apply a coupon code at checkout before payment.",
             kind: "secondary",
         },
         "remove-coupon": {
+            iconKey: "delete",
             id: "checkout.remove-coupon",
             label: "Remove coupon",
             description: "Remove an applied coupon from the current checkout session.",
@@ -2050,18 +2487,21 @@ export const ACTIONS = {
     },
     NAV: {
         "sign-in": {
+            iconKey: "user",
             id: "nav.sign-in",
             label: "Sign in",
             description: "Navigate to the sign-in page.",
             kind: "primary",
         },
         "sign-up": {
+            iconKey: "user",
             id: "nav.sign-up",
             label: "Sign up",
             description: "Navigate to the registration page.",
             kind: "secondary",
         },
         "sign-out": {
+            iconKey: "back",
             id: "nav.sign-out",
             label: "Sign out",
             description: "End the current session.",
@@ -2075,6 +2515,7 @@ export const ACTIONS = {
     },
     MEDIA: {
         "copy-url": {
+            iconKey: "duplicate",
             id: "media.copy-url",
             label: "Copy URL",
             ariaLabel: "Copy media URL to clipboard",
@@ -2082,6 +2523,7 @@ export const ACTIONS = {
             kind: "ghost",
         },
         "clear-previews": {
+            iconKey: "delete",
             id: "media.clear-previews",
             label: "Clear previews",
             ariaLabel: "Clear uploaded previews",
@@ -2090,6 +2532,7 @@ export const ACTIONS = {
             permissions: ["admin", "moderator"],
         },
         "discard-staged": {
+            iconKey: "delete",
             id: "media.discard-staged",
             label: "Discard staged uploads",
             ariaLabel: "Discard all staged uploads",
@@ -2106,6 +2549,7 @@ export const ACTIONS = {
     },
     SUPPORT: {
         "create-ticket": {
+            iconKey: "create",
             id: "support.create-ticket",
             label: "Contact Support",
             ariaLabel: "Create a support ticket",
@@ -2113,6 +2557,7 @@ export const ACTIONS = {
             kind: "primary",
         },
         "reply-ticket": {
+            iconKey: "reply",
             id: "support.reply-ticket",
             label: "Reply",
             ariaLabel: "Reply to this ticket",
@@ -2120,6 +2565,7 @@ export const ACTIONS = {
             kind: "primary",
         },
         "close-ticket": {
+            iconKey: "cancel",
             id: "support.close-ticket",
             label: "Close Ticket",
             ariaLabel: "Close this support ticket",
@@ -2134,6 +2580,7 @@ export const ACTIONS = {
     },
     TESTER: {
         "save-note": {
+            iconKey: "save",
             id: "tester.save-note",
             label: "Save Note",
             ariaLabel: "Save comment and screenshot for this step",
@@ -2143,12 +2590,14 @@ export const ACTIONS = {
     },
     LOTTERY: {
         "pull": {
+            iconKey: "retry",
             id: "lottery.pull",
             label: "Submit Entry",
             description: "Submit a lottery pull entry — slot assigned immediately.",
             kind: "primary",
         },
         "flag-entry": {
+            iconKey: "report",
             id: "lottery.flag-entry",
             label: "Flag as Scammer",
             description: "Flag a lottery entry as fraudulent.",
@@ -2162,6 +2611,7 @@ export const ACTIONS = {
             },
         },
         "reopen-slot": {
+            iconKey: "restore",
             id: "lottery.reopen-slot",
             label: "Reopen Slot",
             description: "Free a flagged entry's slot so it can be claimed again.",
@@ -2174,6 +2624,7 @@ export const ACTIONS = {
             },
         },
         "cancel": {
+            iconKey: "cancel",
             id: "lottery.cancel",
             label: "Cancel Lottery",
             description: "Close the draw window and reject pending pulls.",