@mohasinac/appkit 4.7.3 → 4.8.0

package/dist/ui/columns/column-renderers.js

@@ -45,6 +45,141 @@ export function renderNullable(value, format, fallback = "—") {
         return fallback;
     return format ? format(value) : String(value);
 }
+/**
+ * Normalizes the wide variety of status-string values used across
+ * collections (order status, product status, payout status, ban status,
+ * etc.) into one of 5 semantic tones, so a single badge component can
+ * color-code every dashboard table consistently instead of every status
+ * pill rendering the same flat color regardless of meaning.
+ */
+const STATUS_TONE_MAP = {
+    // success
+    published: "success",
+    active: "success",
+    paid: "success",
+    delivered: "success",
+    won: "success",
+    approved: "success",
+    confirmed: "success",
+    completed: "success",
+    verified: "success",
+    in_stock: "success",
+    resolved: "success",
+    shipped: "success",
+    yes: "success",
+    true: "success",
+    done: "success",
+    success: "success",
+    // warning
+    pending: "warning",
+    processing: "warning",
+    draft: "warning",
+    low_stock: "warning",
+    waitlisted: "warning",
+    in_review: "warning",
+    open: "warning",
+    return_requested: "warning",
+    soft_bans: "warning",
+    // error
+    failed: "error",
+    cancelled: "error",
+    canceled: "error",
+    rejected: "error",
+    banned: "error",
+    hard_banned: "error",
+    disabled: "error",
+    refunded: "error",
+    out_of_stock: "error",
+    expired: "error",
+    declined: "error",
+    removed: "error",
+    suspended: "error",
+    no: "error",
+    false: "error",
+    // info
+    scheduled: "info",
+    closed: "info",
+};
+/** Map a raw status string to a semantic tone for badge coloring. */
+export function getStatusTone(status) {
+    if (!status)
+        return "neutral";
+    const normalized = status
+        .toLowerCase()
+        .trim()
+        .replace(/[\s-]+/g, "_")
+        .replace(/\(.*\)$/, "")
+        .trim();
+    return STATUS_TONE_MAP[normalized] ?? "neutral";
+}
+// --- Resource icon --------------------------------------------------------------
+/**
+ * One emoji per dashboard resource type, keyed by the 2nd segment of a
+ * `ListingViewConfig.queryKey` (e.g. `["admin","users","listing"]` -> "users").
+ * Used as the row-avatar fallback for tables/cards whose rows have no
+ * per-row photo/thumbnail — gives every dashboard table a visual anchor
+ * instead of plain text on a white/black background.
+ */
+const RESOURCE_ICON_MAP = {
+    users: "👤",
+    team: "🧑‍💼",
+    stores: "🏪",
+    products: "📦",
+    art: "🎨",
+    stickers: "🏷️",
+    "live-items": "🔴",
+    "digital-codes": "🔑",
+    classified: "📋",
+    "pre-orders": "🕓",
+    "prize-draws": "🎁",
+    auctions: "🔨",
+    bundles: "🎀",
+    bids: "🔨",
+    orders: "🧾",
+    payouts: "💰",
+    "payout-methods": "💳",
+    coupons: "🎟️",
+    reviews: "⭐",
+    blog: "📝",
+    events: "🎉",
+    "event-entries": "🎫",
+    notifications: "🔔",
+    carts: "🛒",
+    wishlists: "💝",
+    history: "🕐",
+    categories: "🏷️",
+    brands: "🏷️",
+    faqs: "❓",
+    carousel: "🖼️",
+    addresses: "📍",
+    "address-clusters": "📍",
+    "store-addresses": "📍",
+    sessions: "💻",
+    scammers: "🚫",
+    "support-tickets": "🎫",
+    "return-requests": "↩️",
+    contact: "✉️",
+    newsletter: "📰",
+    "grouped-listings": "🧷",
+    shipments: "🚚",
+    features: "🧩",
+    "payment-methods": "💳",
+    "shipping-configs": "🚚",
+    "store-categories": "🏷️",
+    "sublisting-categories": "🏷️",
+    "tester-checklist-items": "✅",
+    "tester-feedback": "💬",
+    "catalogue-approvals": "📚",
+    offers: "🤝",
+};
+/** Fallback icon for any resource not in the map. */
+const RESOURCE_ICON_FALLBACK = "📄";
+/** Resolve a resource-type icon from a `queryKey[1]`-style resource name. */
+export function getResourceIcon(resourceKey) {
+    if (!resourceKey)
+        return RESOURCE_ICON_FALLBACK;
+    return RESOURCE_ICON_MAP[resourceKey] ?? RESOURCE_ICON_FALLBACK;
+}
 /** Render a rating value as "4.2 (31)" or "★★★★☆". */
 export function renderRating(rating, reviewCount, opts) {
     if (rating == null)

package/dist/ui/columns/index.d.ts

@@ -2,5 +2,5 @@
  * Barrel for shared column utilities.
  */
 export { buildColumns, createColumnBuilder } from "./build-columns";
-export { renderBoolean, renderCurrency, renderCurrencyCompact, renderCount, renderNullable, renderRating, } from "./column-renderers";
-export type { BooleanRenderOpts, RatingMode, RatingRenderOpts, } from "./column-renderers";
+export { renderBoolean, renderCurrency, renderCurrencyCompact, renderCount, renderNullable, renderRating, getStatusTone, getResourceIcon, } from "./column-renderers";
+export type { BooleanRenderOpts, RatingMode, RatingRenderOpts, StatusTone, } from "./column-renderers";

package/dist/ui/columns/index.js

@@ -2,4 +2,4 @@
  * Barrel for shared column utilities.
  */
 export { buildColumns, createColumnBuilder } from "./build-columns";
-export { renderBoolean, renderCurrency, renderCurrencyCompact, renderCount, renderNullable, renderRating, } from "./column-renderers";
+export { renderBoolean, renderCurrency, renderCurrencyCompact, renderCount, renderNullable, renderRating, getStatusTone, getResourceIcon, } from "./column-renderers";

package/dist/ui/index.d.ts

@@ -10,8 +10,8 @@ export type { FieldCheckboxProps } from "./forms";
 export { FieldCheckbox } from "./forms";
 export type { FieldTextareaProps } from "./forms";
 export { FieldTextarea } from "./forms";
-export { buildColumns, createColumnBuilder, renderBoolean, renderCurrency, renderCurrencyCompact, renderCount, renderNullable, renderRating, } from "./columns";
-export type { BooleanRenderOpts, RatingMode, RatingRenderOpts, } from "./columns";
+export { buildColumns, createColumnBuilder, renderBoolean, renderCurrency, renderCurrencyCompact, renderCount, renderNullable, renderRating, getStatusTone, getResourceIcon, } from "./columns";
+export type { BooleanRenderOpts, RatingMode, RatingRenderOpts, StatusTone, } from "./columns";
 export type { SectionProps, SectionBackgroundConfig, ArticleProps, MainProps, AsideProps, NavProps, BlockHeaderProps, BlockFooterProps, UlProps, OlProps, LiProps, TableProps, TheadProps, TbodyProps, TrProps, ThProps, TdProps, CodeProps, PreProps, BlockquoteProps, FigureProps, FigcaptionProps, DlProps, DtProps, DdProps, } from "./components/Semantic";
 export { Section, sectionBackgroundStyle, Article, Main, Aside, Nav, BlockHeader, BlockFooter, Ul, Ol, Li, Table, Thead, Tbody, Tr, Th, Td, Code, Pre, Blockquote, Figure, Figcaption, Dl, Dt, Dd, } from "./components/Semantic";
 export type { DivProps } from "./components/Div";

package/dist/ui/index.js

@@ -6,7 +6,7 @@ export { FieldSelect } from "./forms";
 export { FieldCheckbox } from "./forms";
 export { FieldTextarea } from "./forms";
 // --- Column utilities ---------------------------------------------------------
-export { buildColumns, createColumnBuilder, renderBoolean, renderCurrency, renderCurrencyCompact, renderCount, renderNullable, renderRating, } from "./columns";
+export { buildColumns, createColumnBuilder, renderBoolean, renderCurrency, renderCurrencyCompact, renderCount, renderNullable, renderRating, getStatusTone, getResourceIcon, } from "./columns";
 export { Section, sectionBackgroundStyle, Article, Main, Aside, Nav, BlockHeader, BlockFooter, Ul, Ol, Li, Table, Thead, Tbody, Tr, Th, Td, Code, Pre, Blockquote, Figure, Figcaption, Dl, Dt, Dd, } from "./components/Semantic";
 export { Div } from "./components/Div";
 export { Heading, Text, Label, Caption, Span } from "./components/Typography";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mohasinac/appkit",
-  "version": "4.7.3",
+  "version": "4.8.0",
   "license": "MIT",
   "publishConfig": {
     "access": "public"