@designa8/vibedesign-stripe-deepseek-85ea 0.2.1 → 0.2.3

package/README.md

@@ -1,6 +1,6 @@
 # @designa8/vibedesign-stripe-deepseek-85ea
 
-Complete design system generated by Atoms Design, version **0.2.1**.
+Complete design system generated by Atoms Design, version **0.2.3**.
 Tokens, atoms, molecules, organisms, and templates — import from the package root;
 never hardcode visual values in consumer code.
 

package/dist/index.cjs

@@ -239,7 +239,8 @@ var ICON_REGISTRY = {
   "server": { viewBox: "0 0 24 24", nodes: [{ tag: "rect", width: "20", height: "8", x: "2", y: "2", rx: "2", ry: "2" }, { tag: "rect", width: "20", height: "8", x: "2", y: "14", rx: "2", ry: "2" }, { tag: "line", x1: "6", x2: "6.01", y1: "6", y2: "6" }, { tag: "line", x1: "6", x2: "6.01", y1: "18", y2: "18" }] },
   "grip-vertical": { viewBox: "0 0 24 24", nodes: [{ tag: "circle", cx: "9", cy: "12", r: "1" }, { tag: "circle", cx: "9", cy: "5", r: "1" }, { tag: "circle", cx: "9", cy: "19", r: "1" }, { tag: "circle", cx: "15", cy: "12", r: "1" }, { tag: "circle", cx: "15", cy: "5", r: "1" }, { tag: "circle", cx: "15", cy: "19", r: "1" }] },
   "euro": { viewBox: "0 0 24 24", nodes: [{ tag: "path", d: "M4 10h12" }, { tag: "path", d: "M4 14h9" }, { tag: "path", d: "M19 6a7.7 7.7 0 0 0-5.2-2A7.9 7.9 0 0 0 6 12c0 4.4 3.5 8 7.8 8 2 0 3.8-.8 5.2-2" }] },
-  "square": { viewBox: "0 0 24 24", nodes: [{ tag: "rect", width: "18", height: "18", x: "3", y: "3", rx: "2" }] }
+  "square": { viewBox: "0 0 24 24", nodes: [{ tag: "rect", width: "18", height: "18", x: "3", y: "3", rx: "2" }] },
+  "eye-off": { viewBox: "0 0 24 24", nodes: [{ tag: "path", d: "M10.733 5.076a10.744 10.744 0 0 1 11.205 6.575 1 1 0 0 1 0 .696 10.747 10.747 0 0 1-1.444 2.49" }, { tag: "path", d: "M14.084 14.158a3 3 0 0 1-4.242-4.242" }, { tag: "path", d: "M17.479 17.499a10.75 10.75 0 0 1-15.417-5.151 1 1 0 0 1 0-.696 10.75 10.75 0 0 1 4.446-5.143" }, { tag: "path", d: "m2 2 20 20" }] }
 };
 
 // virtual-pkg:src/atoms/Icon/Icon.tsx
@@ -14669,12 +14670,59 @@ var glyph3 = (name, size = 16, strokeWidth = 1.75) => /* @__PURE__ */ (0, import
     style: { color: "inherit" }
   }
 );
+var hasBadge = (badge) => {
+  if (badge === void 0 || badge === null) {
+    return false;
+  }
+  if (typeof badge === "number") {
+    return Number.isFinite(badge) && badge !== 0;
+  }
+  const trimmed = badge.trim();
+  return trimmed.length > 0 && trimmed !== "0";
+};
+var badgeText = (badge) => typeof badge === "number" ? badge > 99 ? "99+" : String(badge) : badge.trim();
+var rowAccessibleName = (label, badge) => {
+  if (!hasBadge(badge)) {
+    return label;
+  }
+  return typeof badge === "number" ? `${label}, ${badge} pending` : `${label}, ${badgeText(badge)}`;
+};
+var RailBadge = ({
+  badge,
+  active
+}) => /* @__PURE__ */ (0, import_jsx_runtime74.jsx)(
+  "span",
+  {
+    "aria-hidden": "true",
+    "data-active": active || void 0,
+    className: cn65(
+      "ml-auto flex h-4 min-w-4 shrink-0 items-center justify-center rounded-full",
+      "bg-primary px-xxs text-caption text-on-primary",
+      "data-[active=true]:bg-on-primary data-[active=true]:text-primary"
+    ),
+    children: badgeText(badge)
+  }
+);
+var railGlyph = (item, folded) => /* @__PURE__ */ (0, import_jsx_runtime74.jsxs)("span", { className: "relative inline-flex shrink-0 items-center", children: [
+  glyph3(item.icon, 16, 1.75),
+  folded && hasBadge(item.badge) ? /* @__PURE__ */ (0, import_jsx_runtime74.jsx)(
+    "span",
+    {
+      "aria-hidden": "true",
+      className: cn65(
+        "pointer-events-none absolute -right-xxs -top-xxs size-2 rounded-full",
+        "bg-primary",
+        "group-data-[active=true]:bg-on-primary"
+      )
+    }
+  ) : null
+] });
 var RowLabel = ({
   folded,
   children
 }) => folded ? /* @__PURE__ */ (0, import_jsx_runtime74.jsx)("span", { className: "sr-only", children }) : /* @__PURE__ */ (0, import_jsx_runtime74.jsx)("span", { className: "truncate", children });
 var railRowClass = (active, folded) => cn65(
-  "flex w-full cursor-pointer items-center rounded-lg border-0 bg-transparent",
+  "group flex w-full cursor-pointer items-center rounded-lg border-0 bg-transparent",
   "text-body-md transition duration-150 ease-out",
   "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-focus-blue",
   "focus-visible:ring-inset",
@@ -15010,6 +15058,7 @@ var SidebarDesktop = React74.forwardRef(
                 className: "flex flex-col gap-xxs",
                 children: navItems.map((item) => {
                   const active = item.id === activeId;
+                  const badged = hasBadge(item.badge);
                   if (!item.children?.length) {
                     return /* @__PURE__ */ (0, import_jsx_runtime74.jsxs)(
                       "a",
@@ -15017,11 +15066,13 @@ var SidebarDesktop = React74.forwardRef(
                         href: item.href ?? `#${item.id}`,
                         onClick: navigate({ id: item.id, href: item.href }),
                         "aria-current": active ? "page" : void 0,
-                        "aria-label": isFolded ? item.label : void 0,
+                        "data-active": active,
+                        "aria-label": isFolded || badged ? rowAccessibleName(item.label, item.badge) : void 0,
                         className: railRowClass(active, isFolded),
                         children: [
-                          glyph3(item.icon, 16, 1.75),
-                          /* @__PURE__ */ (0, import_jsx_runtime74.jsx)(RowLabel, { folded: isFolded, children: item.label })
+                          railGlyph(item, isFolded),
+                          /* @__PURE__ */ (0, import_jsx_runtime74.jsx)(RowLabel, { folded: isFolded, children: item.label }),
+                          !isFolded && badged ? /* @__PURE__ */ (0, import_jsx_runtime74.jsx)(RailBadge, { badge: item.badge, active }) : null
                         ]
                       },
                       item.id
@@ -15037,22 +15088,32 @@ var SidebarDesktop = React74.forwardRef(
                         size: "rail",
                         "aria-expanded": expanded,
                         "aria-controls": subId,
-                        "aria-label": isFolded ? item.label : void 0,
+                        "aria-label": isFolded || badged ? rowAccessibleName(item.label, item.badge) : void 0,
                         "data-active": active,
                         "data-folded": isFolded,
                         onClick: () => toggleExpanded(item.id),
-                        leadingIcon: glyph3(item.icon, 16, 1.75),
-                        trailingIcon: isFolded ? void 0 : /* @__PURE__ */ (0, import_jsx_runtime74.jsx)(
-                          "span",
-                          {
-                            "aria-hidden": "true",
-                            className: cn65(
-                              "flex shrink-0 items-center transition-transform duration-200 ease-out",
-                              expanded ? "rotate-180" : "rotate-0"
-                            ),
-                            children: glyph3("chevron-down", 16, 2)
-                          }
-                        ),
+                        className: "group",
+                        leadingIcon: railGlyph(item, isFolded),
+                        trailingIcon: isFolded ? void 0 : /* @__PURE__ */ (0, import_jsx_runtime74.jsxs)("span", { className: "flex items-center gap-xs", children: [
+                          badged ? /* @__PURE__ */ (0, import_jsx_runtime74.jsx)(
+                            RailBadge,
+                            {
+                              badge: item.badge,
+                              active
+                            }
+                          ) : null,
+                          /* @__PURE__ */ (0, import_jsx_runtime74.jsx)(
+                            "span",
+                            {
+                              "aria-hidden": "true",
+                              className: cn65(
+                                "flex shrink-0 items-center transition-transform duration-200 ease-out",
+                                expanded ? "rotate-180" : "rotate-0"
+                              ),
+                              children: glyph3("chevron-down", 16, 2)
+                            }
+                          )
+                        ] }),
                         children: /* @__PURE__ */ (0, import_jsx_runtime74.jsx)(RowLabel, { folded: isFolded, children: item.label })
                       }
                     ),
@@ -15105,17 +15166,20 @@ var SidebarDesktop = React74.forwardRef(
             ),
             /* @__PURE__ */ (0, import_jsx_runtime74.jsx)("nav", { "aria-label": "Secondary", className: "mt-lg flex flex-col gap-xxs", children: secondaryNav.map((item) => {
               const active = item.id === secondaryActiveId;
+              const badged = hasBadge(item.badge);
               return /* @__PURE__ */ (0, import_jsx_runtime74.jsxs)(
                 "a",
                 {
                   href: item.href ?? `#${item.id}`,
                   onClick: navigate({ id: item.id, href: item.href }),
                   "aria-current": active ? "page" : void 0,
-                  "aria-label": isFolded ? item.label : void 0,
+                  "data-active": active,
+                  "aria-label": isFolded || badged ? rowAccessibleName(item.label, item.badge) : void 0,
                   className: railRowClass(active, isFolded),
                   children: [
-                    glyph3(item.icon, 16, 1.75),
-                    /* @__PURE__ */ (0, import_jsx_runtime74.jsx)(RowLabel, { folded: isFolded, children: item.label })
+                    railGlyph(item, isFolded),
+                    /* @__PURE__ */ (0, import_jsx_runtime74.jsx)(RowLabel, { folded: isFolded, children: item.label }),
+                    !isFolded && badged ? /* @__PURE__ */ (0, import_jsx_runtime74.jsx)(RailBadge, { badge: item.badge, active }) : null
                   ]
                 },
                 item.id
@@ -15242,6 +15306,39 @@ var SAMPLE_SECONDARY2 = [
 ];
 var SAMPLE_PLAN2 = { name: "Pro", price: "$2,400.00 / month", href: "#plan" };
 var glyph4 = (name, size = 18, strokeWidth = 1.75) => /* @__PURE__ */ (0, import_jsx_runtime75.jsx)(Icon, { name, size, strokeWidth, style: { color: "inherit" } });
+var hasBadge2 = (badge) => {
+  if (badge === void 0 || badge === null) {
+    return false;
+  }
+  if (typeof badge === "number") {
+    return Number.isFinite(badge) && badge !== 0;
+  }
+  const trimmed = badge.trim();
+  return trimmed.length > 0 && trimmed !== "0";
+};
+var badgeText2 = (badge) => typeof badge === "number" ? badge > 99 ? "99+" : String(badge) : badge.trim();
+var rowAccessibleName2 = (label, badge) => {
+  if (!hasBadge2(badge)) {
+    return label;
+  }
+  return typeof badge === "number" ? `${label}, ${badge} pending` : `${label}, ${badgeText2(badge)}`;
+};
+var NavBadge = ({
+  badge,
+  active
+}) => /* @__PURE__ */ (0, import_jsx_runtime75.jsx)(
+  "span",
+  {
+    "aria-hidden": "true",
+    "data-active": active || void 0,
+    className: cn66(
+      "ml-auto flex h-4 min-w-4 shrink-0 items-center justify-center rounded-full",
+      "bg-primary px-xxs text-caption text-on-primary",
+      "data-[active=true]:bg-on-primary data-[active=true]:text-primary"
+    ),
+    children: badgeText2(badge)
+  }
+);
 var rowClass = (active) => cn66(
   "flex min-h-10 w-full cursor-pointer items-center gap-md rounded-lg px-md py-sm",
   "text-body-md transition duration-150 ease-out",
@@ -15554,6 +15651,7 @@ var SidebarMobile = React75.forwardRef(
                     ] }),
                     /* @__PURE__ */ (0, import_jsx_runtime75.jsx)("nav", { "aria-label": "Primary", className: "mt-md flex flex-col gap-xxs", children: navItems.map((item) => {
                       const active = item.id === activeId;
+                      const badged = hasBadge2(item.badge);
                       if (!item.children?.length) {
                         return /* @__PURE__ */ (0, import_jsx_runtime75.jsxs)(
                           "a",
@@ -15561,10 +15659,18 @@ var SidebarMobile = React75.forwardRef(
                             href: item.href ?? `#${item.id}`,
                             onClick: navigate({ id: item.id, href: item.href }),
                             "aria-current": active ? "page" : void 0,
+                            "aria-label": badged ? rowAccessibleName2(item.label, item.badge) : void 0,
                             className: rowClass(active),
                             children: [
                               glyph4(item.icon, 18, 1.75),
-                              /* @__PURE__ */ (0, import_jsx_runtime75.jsx)("span", { className: "truncate", children: item.label })
+                              /* @__PURE__ */ (0, import_jsx_runtime75.jsx)("span", { className: "truncate", children: item.label }),
+                              badged ? /* @__PURE__ */ (0, import_jsx_runtime75.jsx)(
+                                NavBadge,
+                                {
+                                  badge: item.badge,
+                                  active
+                                }
+                              ) : null
                             ]
                           },
                           item.id
@@ -15580,20 +15686,31 @@ var SidebarMobile = React75.forwardRef(
                             size: "rail",
                             "aria-expanded": expanded,
                             "aria-controls": subId,
+                            "aria-label": badged ? rowAccessibleName2(item.label, item.badge) : void 0,
                             "data-active": active,
                             onClick: () => toggleExpanded(item.id),
                             className: "px-md",
                             leadingIcon: glyph4(item.icon, 18, 1.75),
-                            trailingIcon: /* @__PURE__ */ (0, import_jsx_runtime75.jsx)(
-                              "span",
-                              {
-                                className: cn66(
-                                  "flex shrink-0 items-center transition-transform duration-200 ease-out",
-                                  expanded ? "rotate-180" : "rotate-0"
-                                ),
-                                children: glyph4("chevron-down", 18, 2)
-                              }
-                            ),
+                            trailingIcon: /* @__PURE__ */ (0, import_jsx_runtime75.jsxs)("span", { className: "flex items-center gap-xs", children: [
+                              badged ? /* @__PURE__ */ (0, import_jsx_runtime75.jsx)(
+                                NavBadge,
+                                {
+                                  badge: item.badge,
+                                  active
+                                }
+                              ) : null,
+                              /* @__PURE__ */ (0, import_jsx_runtime75.jsx)(
+                                "span",
+                                {
+                                  "aria-hidden": "true",
+                                  className: cn66(
+                                    "flex shrink-0 items-center transition-transform duration-200 ease-out",
+                                    expanded ? "rotate-180" : "rotate-0"
+                                  ),
+                                  children: glyph4("chevron-down", 18, 2)
+                                }
+                              )
+                            ] }),
                             children: /* @__PURE__ */ (0, import_jsx_runtime75.jsx)("span", { className: "truncate text-left", children: item.label })
                           }
                         ),
@@ -15649,16 +15766,25 @@ var SidebarMobile = React75.forwardRef(
                     /* @__PURE__ */ (0, import_jsx_runtime75.jsx)(Divider, { className: "my-md" }),
                     /* @__PURE__ */ (0, import_jsx_runtime75.jsx)("nav", { "aria-label": "Secondary", className: "flex flex-col gap-xxs", children: secondaryNav.map((item) => {
                       const active = item.id === secondaryActiveId;
+                      const badged = hasBadge2(item.badge);
                       return /* @__PURE__ */ (0, import_jsx_runtime75.jsxs)(
                         "a",
                         {
                           href: item.href ?? `#${item.id}`,
                           onClick: navigate({ id: item.id, href: item.href }),
                           "aria-current": active ? "page" : void 0,
+                          "aria-label": badged ? rowAccessibleName2(item.label, item.badge) : void 0,
                           className: rowClass(active),
                           children: [
                             glyph4(item.icon, 18, 1.75),
-                            /* @__PURE__ */ (0, import_jsx_runtime75.jsx)("span", { className: "truncate", children: item.label })
+                            /* @__PURE__ */ (0, import_jsx_runtime75.jsx)("span", { className: "truncate", children: item.label }),
+                            badged ? /* @__PURE__ */ (0, import_jsx_runtime75.jsx)(
+                              NavBadge,
+                              {
+                                badge: item.badge,
+                                active
+                              }
+                            ) : null
                           ]
                         },
                         item.id

package/dist/index.js

@@ -102,7 +102,8 @@ var ICON_REGISTRY = {
   "server": { viewBox: "0 0 24 24", nodes: [{ tag: "rect", width: "20", height: "8", x: "2", y: "2", rx: "2", ry: "2" }, { tag: "rect", width: "20", height: "8", x: "2", y: "14", rx: "2", ry: "2" }, { tag: "line", x1: "6", x2: "6.01", y1: "6", y2: "6" }, { tag: "line", x1: "6", x2: "6.01", y1: "18", y2: "18" }] },
   "grip-vertical": { viewBox: "0 0 24 24", nodes: [{ tag: "circle", cx: "9", cy: "12", r: "1" }, { tag: "circle", cx: "9", cy: "5", r: "1" }, { tag: "circle", cx: "9", cy: "19", r: "1" }, { tag: "circle", cx: "15", cy: "12", r: "1" }, { tag: "circle", cx: "15", cy: "5", r: "1" }, { tag: "circle", cx: "15", cy: "19", r: "1" }] },
   "euro": { viewBox: "0 0 24 24", nodes: [{ tag: "path", d: "M4 10h12" }, { tag: "path", d: "M4 14h9" }, { tag: "path", d: "M19 6a7.7 7.7 0 0 0-5.2-2A7.9 7.9 0 0 0 6 12c0 4.4 3.5 8 7.8 8 2 0 3.8-.8 5.2-2" }] },
-  "square": { viewBox: "0 0 24 24", nodes: [{ tag: "rect", width: "18", height: "18", x: "3", y: "3", rx: "2" }] }
+  "square": { viewBox: "0 0 24 24", nodes: [{ tag: "rect", width: "18", height: "18", x: "3", y: "3", rx: "2" }] },
+  "eye-off": { viewBox: "0 0 24 24", nodes: [{ tag: "path", d: "M10.733 5.076a10.744 10.744 0 0 1 11.205 6.575 1 1 0 0 1 0 .696 10.747 10.747 0 0 1-1.444 2.49" }, { tag: "path", d: "M14.084 14.158a3 3 0 0 1-4.242-4.242" }, { tag: "path", d: "M17.479 17.499a10.75 10.75 0 0 1-15.417-5.151 1 1 0 0 1 0-.696 10.75 10.75 0 0 1 4.446-5.143" }, { tag: "path", d: "m2 2 20 20" }] }
 };
 
 // virtual-pkg:src/atoms/Icon/Icon.tsx
@@ -14532,12 +14533,59 @@ var glyph3 = (name, size = 16, strokeWidth = 1.75) => /* @__PURE__ */ jsx74(
     style: { color: "inherit" }
   }
 );
+var hasBadge = (badge) => {
+  if (badge === void 0 || badge === null) {
+    return false;
+  }
+  if (typeof badge === "number") {
+    return Number.isFinite(badge) && badge !== 0;
+  }
+  const trimmed = badge.trim();
+  return trimmed.length > 0 && trimmed !== "0";
+};
+var badgeText = (badge) => typeof badge === "number" ? badge > 99 ? "99+" : String(badge) : badge.trim();
+var rowAccessibleName = (label, badge) => {
+  if (!hasBadge(badge)) {
+    return label;
+  }
+  return typeof badge === "number" ? `${label}, ${badge} pending` : `${label}, ${badgeText(badge)}`;
+};
+var RailBadge = ({
+  badge,
+  active
+}) => /* @__PURE__ */ jsx74(
+  "span",
+  {
+    "aria-hidden": "true",
+    "data-active": active || void 0,
+    className: cn65(
+      "ml-auto flex h-4 min-w-4 shrink-0 items-center justify-center rounded-full",
+      "bg-primary px-xxs text-caption text-on-primary",
+      "data-[active=true]:bg-on-primary data-[active=true]:text-primary"
+    ),
+    children: badgeText(badge)
+  }
+);
+var railGlyph = (item, folded) => /* @__PURE__ */ jsxs71("span", { className: "relative inline-flex shrink-0 items-center", children: [
+  glyph3(item.icon, 16, 1.75),
+  folded && hasBadge(item.badge) ? /* @__PURE__ */ jsx74(
+    "span",
+    {
+      "aria-hidden": "true",
+      className: cn65(
+        "pointer-events-none absolute -right-xxs -top-xxs size-2 rounded-full",
+        "bg-primary",
+        "group-data-[active=true]:bg-on-primary"
+      )
+    }
+  ) : null
+] });
 var RowLabel = ({
   folded,
   children
 }) => folded ? /* @__PURE__ */ jsx74("span", { className: "sr-only", children }) : /* @__PURE__ */ jsx74("span", { className: "truncate", children });
 var railRowClass = (active, folded) => cn65(
-  "flex w-full cursor-pointer items-center rounded-lg border-0 bg-transparent",
+  "group flex w-full cursor-pointer items-center rounded-lg border-0 bg-transparent",
   "text-body-md transition duration-150 ease-out",
   "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-focus-blue",
   "focus-visible:ring-inset",
@@ -14873,6 +14921,7 @@ var SidebarDesktop = React74.forwardRef(
                 className: "flex flex-col gap-xxs",
                 children: navItems.map((item) => {
                   const active = item.id === activeId;
+                  const badged = hasBadge(item.badge);
                   if (!item.children?.length) {
                     return /* @__PURE__ */ jsxs71(
                       "a",
@@ -14880,11 +14929,13 @@ var SidebarDesktop = React74.forwardRef(
                         href: item.href ?? `#${item.id}`,
                         onClick: navigate({ id: item.id, href: item.href }),
                         "aria-current": active ? "page" : void 0,
-                        "aria-label": isFolded ? item.label : void 0,
+                        "data-active": active,
+                        "aria-label": isFolded || badged ? rowAccessibleName(item.label, item.badge) : void 0,
                         className: railRowClass(active, isFolded),
                         children: [
-                          glyph3(item.icon, 16, 1.75),
-                          /* @__PURE__ */ jsx74(RowLabel, { folded: isFolded, children: item.label })
+                          railGlyph(item, isFolded),
+                          /* @__PURE__ */ jsx74(RowLabel, { folded: isFolded, children: item.label }),
+                          !isFolded && badged ? /* @__PURE__ */ jsx74(RailBadge, { badge: item.badge, active }) : null
                         ]
                       },
                       item.id
@@ -14900,22 +14951,32 @@ var SidebarDesktop = React74.forwardRef(
                         size: "rail",
                         "aria-expanded": expanded,
                         "aria-controls": subId,
-                        "aria-label": isFolded ? item.label : void 0,
+                        "aria-label": isFolded || badged ? rowAccessibleName(item.label, item.badge) : void 0,
                         "data-active": active,
                         "data-folded": isFolded,
                         onClick: () => toggleExpanded(item.id),
-                        leadingIcon: glyph3(item.icon, 16, 1.75),
-                        trailingIcon: isFolded ? void 0 : /* @__PURE__ */ jsx74(
-                          "span",
-                          {
-                            "aria-hidden": "true",
-                            className: cn65(
-                              "flex shrink-0 items-center transition-transform duration-200 ease-out",
-                              expanded ? "rotate-180" : "rotate-0"
-                            ),
-                            children: glyph3("chevron-down", 16, 2)
-                          }
-                        ),
+                        className: "group",
+                        leadingIcon: railGlyph(item, isFolded),
+                        trailingIcon: isFolded ? void 0 : /* @__PURE__ */ jsxs71("span", { className: "flex items-center gap-xs", children: [
+                          badged ? /* @__PURE__ */ jsx74(
+                            RailBadge,
+                            {
+                              badge: item.badge,
+                              active
+                            }
+                          ) : null,
+                          /* @__PURE__ */ jsx74(
+                            "span",
+                            {
+                              "aria-hidden": "true",
+                              className: cn65(
+                                "flex shrink-0 items-center transition-transform duration-200 ease-out",
+                                expanded ? "rotate-180" : "rotate-0"
+                              ),
+                              children: glyph3("chevron-down", 16, 2)
+                            }
+                          )
+                        ] }),
                         children: /* @__PURE__ */ jsx74(RowLabel, { folded: isFolded, children: item.label })
                       }
                     ),
@@ -14968,17 +15029,20 @@ var SidebarDesktop = React74.forwardRef(
             ),
             /* @__PURE__ */ jsx74("nav", { "aria-label": "Secondary", className: "mt-lg flex flex-col gap-xxs", children: secondaryNav.map((item) => {
               const active = item.id === secondaryActiveId;
+              const badged = hasBadge(item.badge);
               return /* @__PURE__ */ jsxs71(
                 "a",
                 {
                   href: item.href ?? `#${item.id}`,
                   onClick: navigate({ id: item.id, href: item.href }),
                   "aria-current": active ? "page" : void 0,
-                  "aria-label": isFolded ? item.label : void 0,
+                  "data-active": active,
+                  "aria-label": isFolded || badged ? rowAccessibleName(item.label, item.badge) : void 0,
                   className: railRowClass(active, isFolded),
                   children: [
-                    glyph3(item.icon, 16, 1.75),
-                    /* @__PURE__ */ jsx74(RowLabel, { folded: isFolded, children: item.label })
+                    railGlyph(item, isFolded),
+                    /* @__PURE__ */ jsx74(RowLabel, { folded: isFolded, children: item.label }),
+                    !isFolded && badged ? /* @__PURE__ */ jsx74(RailBadge, { badge: item.badge, active }) : null
                   ]
                 },
                 item.id
@@ -15105,6 +15169,39 @@ var SAMPLE_SECONDARY2 = [
 ];
 var SAMPLE_PLAN2 = { name: "Pro", price: "$2,400.00 / month", href: "#plan" };
 var glyph4 = (name, size = 18, strokeWidth = 1.75) => /* @__PURE__ */ jsx75(Icon, { name, size, strokeWidth, style: { color: "inherit" } });
+var hasBadge2 = (badge) => {
+  if (badge === void 0 || badge === null) {
+    return false;
+  }
+  if (typeof badge === "number") {
+    return Number.isFinite(badge) && badge !== 0;
+  }
+  const trimmed = badge.trim();
+  return trimmed.length > 0 && trimmed !== "0";
+};
+var badgeText2 = (badge) => typeof badge === "number" ? badge > 99 ? "99+" : String(badge) : badge.trim();
+var rowAccessibleName2 = (label, badge) => {
+  if (!hasBadge2(badge)) {
+    return label;
+  }
+  return typeof badge === "number" ? `${label}, ${badge} pending` : `${label}, ${badgeText2(badge)}`;
+};
+var NavBadge = ({
+  badge,
+  active
+}) => /* @__PURE__ */ jsx75(
+  "span",
+  {
+    "aria-hidden": "true",
+    "data-active": active || void 0,
+    className: cn66(
+      "ml-auto flex h-4 min-w-4 shrink-0 items-center justify-center rounded-full",
+      "bg-primary px-xxs text-caption text-on-primary",
+      "data-[active=true]:bg-on-primary data-[active=true]:text-primary"
+    ),
+    children: badgeText2(badge)
+  }
+);
 var rowClass = (active) => cn66(
   "flex min-h-10 w-full cursor-pointer items-center gap-md rounded-lg px-md py-sm",
   "text-body-md transition duration-150 ease-out",
@@ -15417,6 +15514,7 @@ var SidebarMobile = React75.forwardRef(
                     ] }),
                     /* @__PURE__ */ jsx75("nav", { "aria-label": "Primary", className: "mt-md flex flex-col gap-xxs", children: navItems.map((item) => {
                       const active = item.id === activeId;
+                      const badged = hasBadge2(item.badge);
                       if (!item.children?.length) {
                         return /* @__PURE__ */ jsxs72(
                           "a",
@@ -15424,10 +15522,18 @@ var SidebarMobile = React75.forwardRef(
                             href: item.href ?? `#${item.id}`,
                             onClick: navigate({ id: item.id, href: item.href }),
                             "aria-current": active ? "page" : void 0,
+                            "aria-label": badged ? rowAccessibleName2(item.label, item.badge) : void 0,
                             className: rowClass(active),
                             children: [
                               glyph4(item.icon, 18, 1.75),
-                              /* @__PURE__ */ jsx75("span", { className: "truncate", children: item.label })
+                              /* @__PURE__ */ jsx75("span", { className: "truncate", children: item.label }),
+                              badged ? /* @__PURE__ */ jsx75(
+                                NavBadge,
+                                {
+                                  badge: item.badge,
+                                  active
+                                }
+                              ) : null
                             ]
                           },
                           item.id
@@ -15443,20 +15549,31 @@ var SidebarMobile = React75.forwardRef(
                             size: "rail",
                             "aria-expanded": expanded,
                             "aria-controls": subId,
+                            "aria-label": badged ? rowAccessibleName2(item.label, item.badge) : void 0,
                             "data-active": active,
                             onClick: () => toggleExpanded(item.id),
                             className: "px-md",
                             leadingIcon: glyph4(item.icon, 18, 1.75),
-                            trailingIcon: /* @__PURE__ */ jsx75(
-                              "span",
-                              {
-                                className: cn66(
-                                  "flex shrink-0 items-center transition-transform duration-200 ease-out",
-                                  expanded ? "rotate-180" : "rotate-0"
-                                ),
-                                children: glyph4("chevron-down", 18, 2)
-                              }
-                            ),
+                            trailingIcon: /* @__PURE__ */ jsxs72("span", { className: "flex items-center gap-xs", children: [
+                              badged ? /* @__PURE__ */ jsx75(
+                                NavBadge,
+                                {
+                                  badge: item.badge,
+                                  active
+                                }
+                              ) : null,
+                              /* @__PURE__ */ jsx75(
+                                "span",
+                                {
+                                  "aria-hidden": "true",
+                                  className: cn66(
+                                    "flex shrink-0 items-center transition-transform duration-200 ease-out",
+                                    expanded ? "rotate-180" : "rotate-0"
+                                  ),
+                                  children: glyph4("chevron-down", 18, 2)
+                                }
+                              )
+                            ] }),
                             children: /* @__PURE__ */ jsx75("span", { className: "truncate text-left", children: item.label })
                           }
                         ),
@@ -15512,16 +15629,25 @@ var SidebarMobile = React75.forwardRef(
                     /* @__PURE__ */ jsx75(Divider, { className: "my-md" }),
                     /* @__PURE__ */ jsx75("nav", { "aria-label": "Secondary", className: "flex flex-col gap-xxs", children: secondaryNav.map((item) => {
                       const active = item.id === secondaryActiveId;
+                      const badged = hasBadge2(item.badge);
                       return /* @__PURE__ */ jsxs72(
                         "a",
                         {
                           href: item.href ?? `#${item.id}`,
                           onClick: navigate({ id: item.id, href: item.href }),
                           "aria-current": active ? "page" : void 0,
+                          "aria-label": badged ? rowAccessibleName2(item.label, item.badge) : void 0,
                           className: rowClass(active),
                           children: [
                             glyph4(item.icon, 18, 1.75),
-                            /* @__PURE__ */ jsx75("span", { className: "truncate", children: item.label })
+                            /* @__PURE__ */ jsx75("span", { className: "truncate", children: item.label }),
+                            badged ? /* @__PURE__ */ jsx75(
+                              NavBadge,
+                              {
+                                badge: item.badge,
+                                active
+                              }
+                            ) : null
                           ]
                         },
                         item.id

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@designa8/vibedesign-stripe-deepseek-85ea",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "Complete design system \"My Project stripe-deepseek\" generated by Atoms Design.",
   "main": "dist/index.cjs",
   "module": "dist/index.js",

package/src/atoms/Icon/icons.data.ts

@@ -93,6 +93,7 @@ export const ICON_REGISTRY = {
   "grip-vertical": { viewBox: "0 0 24 24", nodes: [{ tag: "circle", cx: "9", cy: "12", r: "1" }, { tag: "circle", cx: "9", cy: "5", r: "1" }, { tag: "circle", cx: "9", cy: "19", r: "1" }, { tag: "circle", cx: "15", cy: "12", r: "1" }, { tag: "circle", cx: "15", cy: "5", r: "1" }, { tag: "circle", cx: "15", cy: "19", r: "1" }] },
   "euro": { viewBox: "0 0 24 24", nodes: [{ tag: "path", d: "M4 10h12" }, { tag: "path", d: "M4 14h9" }, { tag: "path", d: "M19 6a7.7 7.7 0 0 0-5.2-2A7.9 7.9 0 0 0 6 12c0 4.4 3.5 8 7.8 8 2 0 3.8-.8 5.2-2" }] },
   "square": { viewBox: "0 0 24 24", nodes: [{ tag: "rect", width: "18", height: "18", x: "3", y: "3", rx: "2" }] },
+  "eye-off": { viewBox: "0 0 24 24", nodes: [{ tag: "path", d: "M10.733 5.076a10.744 10.744 0 0 1 11.205 6.575 1 1 0 0 1 0 .696 10.747 10.747 0 0 1-1.444 2.49" }, { tag: "path", d: "M14.084 14.158a3 3 0 0 1-4.242-4.242" }, { tag: "path", d: "M17.479 17.499a10.75 10.75 0 0 1-15.417-5.151 1 1 0 0 1 0-.696 10.75 10.75 0 0 1 4.446-5.143" }, { tag: "path", d: "m2 2 20 20" }] },
 } as const;
 
 export type IconName = keyof typeof ICON_REGISTRY;

package/src/atoms/Sidebar/preview.tsx

@@ -2,30 +2,35 @@ import * as React from "react";
 import { Avatar } from "../Avatar";
 import { Button } from "../Button";
 import { Icon } from "../Icon";
-import { SidebarDesktop, type SidebarDesktopNavItem } from "../SidebarDesktop";
-import { SidebarMobile } from "../SidebarMobile";
+import { type SidebarDesktopNavItem } from "../SidebarDesktop";
 import { Sidebar, type SidebarNavTarget } from "./Sidebar";
 
-const ITEMS: SidebarDesktopNavItem[] = [
-  { id: "payments", label: "Payments", icon: "credit-card", href: "/payments" },
+/** Nav fixtures with the count wired to state, so the pill really hides at 0. */
+const buildItems = (pending: number): SidebarDesktopNavItem[] => [
+  {
+    id: "payments",
+    label: "Tasks",
+    icon: "credit-card",
+    href: "/tasks",
+    badge: pending,
+  },
   { id: "balances", label: "Balances", icon: "layers", href: "/balances" },
   {
     id: "payouts",
-    label: "Payouts",
+    label: "Approvals",
     icon: "arrow-left-right",
+    badge: pending,
     children: [
-      { id: "scheduled", label: "Scheduled payouts", href: "/payouts/scheduled" },
-      { id: "payout-accounts", label: "Payout accounts", href: "/payouts/accounts" },
-      { id: "payout-limits", label: "Payout limits", href: "/payouts/limits" },
+      { id: "scheduled", label: "Scheduled payouts", href: "/approvals/scheduled" },
+      { id: "payout-accounts", label: "Payout accounts", href: "/approvals/accounts" },
     ],
   },
   { id: "developers", label: "Developers", icon: "code", href: "/developers" },
-  { id: "api-logs", label: "API logs", icon: "file", href: "/api-logs" },
 ];
 
 const SECONDARY_ITEMS: SidebarDesktopNavItem[] = [
   { id: "settings", label: "Settings", icon: "settings", href: "/settings" },
-  { id: "team", label: "Team", icon: "group", href: "/team" },
+  { id: "team", label: "Team", icon: "group", href: "/team", badge: "New" },
 ];
 
 const ACCOUNTS = [
@@ -35,27 +40,11 @@ const ACCOUNTS = [
 
 const PROFILE = { name: "Priya Shah", email: "priya@acme.com" };
 
-/** A tiny content pane so the routed shell reads as a page, not a floating rail. */
-const ContentPane = ({ route, unread }: { route: string; unread: number }) => (
-  <div className="flex min-w-0 flex-col gap-sm bg-canvas p-lg">
-    <p className="text-caption uppercase text-muted">Current route</p>
-    <p className="text-heading-md text-ink">{route}</p>
-    <p className="text-body-sm text-body">
-      Click any destination in the navigation to route there. The rail keeps its
-      header and footer pinned while the destination list scrolls on its own.
-    </p>
-    <p className="text-body-sm text-body">
-      {unread > 0
-        ? `${unread} unread notifications waiting in the footer bell.`
-        : "Notifications cleared — the badge is gone."}
-    </p>
-  </div>
-);
-
 export default function Preview() {
   const [activeId, setActiveId] = React.useState("payments");
-  const [route, setRoute] = React.useState("/payments");
+  const [route, setRoute] = React.useState("/tasks");
   const [unread, setUnread] = React.useState(4);
+  const [pending, setPending] = React.useState(2);
 
   const handleNavigate = (item: SidebarNavTarget) => {
     setRoute(item.href ?? `#${item.id}`);
@@ -63,99 +52,68 @@ export default function Preview() {
   };
 
   return (
-    <div className="mx-auto w-full max-w-3xl space-y-xl p-lg">
-      {/* The whole control: one instance, responsive in CSS. */}
-      <section className="space-y-sm">
+    <div className="mx-auto w-full max-w-3xl space-y-sm p-lg">
+      <div className="flex flex-wrap items-center justify-between gap-sm">
         <p className="text-caption uppercase text-muted">
-          Routed app shell — rail above md, header below
+          Count pill unfolded, dot on the glyph once folded
         </p>
-        <div className="grid w-full grid-cols-1 overflow-hidden rounded-xl border border-hairline bg-surface md:grid-cols-[auto_minmax(0,1fr)]">
-          <Sidebar
-            wordmark="Nimbus"
-            homeHref="/"
-            items={ITEMS}
-            activeId={activeId}
-            onNavigate={handleNavigate}
-            secondaryItems={SECONDARY_ITEMS}
-            secondaryActiveId="settings"
-            accounts={ACCOUNTS}
-            profile={PROFILE}
-            plan={{ name: "Pro", price: "$2,400.00 / month", href: "/billing" }}
-            notificationCount={unread}
-            onNotifications={() => setUnread(0)}
-            mobileActions={
-              <>
-                <Button variant="bare" size="icon-sm" aria-label="Search">
-                  <Icon name="search" size={20} strokeWidth={1.75} />
-                </Button>
-                <Button variant="bare" size="icon-sm" aria-label="Notifications">
-                  <Icon name="bell" size={20} strokeWidth={1.75} />
-                </Button>
-                <Avatar name={PROFILE.name} size="sm" />
-              </>
-            }
-            mobileDrawerFooter={
-              <Button variant="outline-soft" size="md" fullWidth>
-                Switch theme
-              </Button>
-            }
-          />
-          <ContentPane route={route} unread={unread} />
-        </div>
-      </section>
+        <Button
+          variant="outline-soft"
+          size="sm"
+          onClick={() => setPending((current) => (current === 0 ? 2 : 0))}
+        >
+          {pending === 0 ? "Show pending counts" : "Clear pending counts"}
+        </Button>
+      </div>
 
-      {/* The desktop part on its own, folded down to its icon column. */}
-      <section className="space-y-sm">
-        <p className="text-caption uppercase text-muted">
-          Desktop rail — folded, with a notification badge
-        </p>
-        <div className="grid w-full grid-cols-1 overflow-hidden rounded-xl border border-hairline bg-surface md:grid-cols-[auto_minmax(0,1fr)]">
-          <SidebarDesktop
-            items={ITEMS}
-            activeId={activeId}
-            onNavigate={handleNavigate}
-            secondaryItems={SECONDARY_ITEMS}
-            accounts={ACCOUNTS}
-            profile={PROFILE}
-            notificationCount={12}
-            defaultFolded
-          />
-          <ContentPane route={route} unread={unread} />
-        </div>
-      </section>
-
-      {/* The mobile part: the flush header, with the drawer it opens. */}
-      <section className="space-y-sm">
-        <p className="text-caption uppercase text-muted">
-          Mobile header — tap the menu to open the drawer
-        </p>
-        <div className="w-full overflow-hidden rounded-xl border border-hairline bg-surface">
-          <SidebarMobile
-            items={ITEMS}
-            activeId={activeId}
-            onNavigate={handleNavigate}
-            secondaryItems={SECONDARY_ITEMS}
-            accounts={ACCOUNTS}
-            profile={PROFILE}
-            plan={null}
-            notificationCount={unread}
-            mobileActions={
-              <>
-                <Button variant="bare" size="icon-sm" aria-label="Search">
-                  <Icon name="search" size={20} strokeWidth={1.75} />
-                </Button>
-                <Avatar name={PROFILE.name} size="sm" />
-              </>
-            }
-            mobileDrawerFooter={
-              <Button variant="outline-soft" size="md" fullWidth>
-                Switch theme
+      <div className="grid w-full grid-cols-1 overflow-hidden rounded-xl border border-hairline bg-surface md:grid-cols-[auto_minmax(0,1fr)]">
+        <Sidebar
+          wordmark="Nimbus"
+          homeHref="/"
+          items={buildItems(pending)}
+          activeId={activeId}
+          onNavigate={handleNavigate}
+          secondaryItems={SECONDARY_ITEMS}
+          secondaryActiveId="settings"
+          accounts={ACCOUNTS}
+          profile={PROFILE}
+          plan={{ name: "Pro", price: "$2,400.00 / month", href: "/billing" }}
+          notificationCount={unread}
+          onNotifications={() => setUnread(0)}
+          defaultExpandedId={null}
+          mobileActions={
+            <>
+              <Button variant="bare" size="icon-sm" aria-label="Search">
+                <Icon name="search" size={20} strokeWidth={1.75} />
+              </Button>
+              <Button variant="bare" size="icon-sm" aria-label="Notifications">
+                <Icon name="bell" size={20} strokeWidth={1.75} />
               </Button>
-            }
-          />
-          <ContentPane route={route} unread={unread} />
+              <Avatar name={PROFILE.name} size="sm" />
+            </>
+          }
+          mobileDrawerFooter={
+            <Button variant="outline-soft" size="md" fullWidth>
+              Switch theme
+            </Button>
+          }
+        />
+
+        <div className="flex min-w-0 flex-col gap-sm bg-canvas p-lg">
+          <p className="text-caption uppercase text-muted">Current route</p>
+          <p className="text-heading-md text-ink">{route}</p>
+          <p className="text-body-sm text-body">
+            Tasks carries a count pill after its label. Collapse the rail and the
+            same count becomes a dot on the glyph, while the row still announces
+            the number to a screen reader.
+          </p>
+          <p className="text-body-sm text-body">
+            {unread > 0
+              ? `${unread} unread notifications sit in the footer bell.`
+              : "Notifications cleared — the bell badge is gone."}
+          </p>
         </div>
-      </section>
+      </div>
     </div>
   );
 }

package/src/atoms/SidebarDesktop/SidebarDesktop.tsx

@@ -36,6 +36,12 @@ export interface SidebarDesktopNavItem {
   icon: IconName;
   /** Destination for a plain row. */
   href?: string;
+  /**
+   * Pending-work count painted as a pill after the label, and as a dot on the
+   * glyph while the rail is folded. A number (99+ collapses), or a short string
+   * such as "New". Hidden when undefined, empty, or zero.
+   */
+  badge?: number | string;
   /** Nested rows: turns the parent into a disclosure. */
   children?: Array<{ id: string; label: string; href?: string }>;
 }
@@ -149,6 +155,85 @@ const glyph = (name: IconName, size = 16, strokeWidth = 1.75) => (
   />
 );
 
+/** True when an item carries a count worth painting. Zero and empties hide. */
+const hasBadge = (badge?: number | string) => {
+  if (badge === undefined || badge === null) {
+    return false;
+  }
+  if (typeof badge === "number") {
+    return Number.isFinite(badge) && badge !== 0;
+  }
+  const trimmed = badge.trim();
+  return trimmed.length > 0 && trimmed !== "0";
+};
+
+/** The pill copy: numbers above 99 collapse so a row never reflows. */
+const badgeText = (badge: number | string) =>
+  typeof badge === "number"
+    ? badge > 99
+      ? "99+"
+      : String(badge)
+    : badge.trim();
+
+/**
+ * The row's accessible name. The count rides along as pending work, so a folded
+ * icon rail still announces "API logs, 12 pending" instead of a bare glyph.
+ */
+const rowAccessibleName = (label: string, badge?: number | string) => {
+  if (!hasBadge(badge)) {
+    return label;
+  }
+  return typeof badge === "number"
+    ? `${label}, ${badge} pending`
+    : `${label}, ${badgeText(badge as string)}`;
+};
+
+/**
+ * The count pill that follows a row's label. It wears the same recipe as the
+ * footer bell: the brand fill with inverse type on the navy rail, flipped to the
+ * inverse fill while the row itself is the selected brand block.
+ */
+const RailBadge = ({
+  badge,
+  active,
+}: {
+  badge: number | string;
+  active?: boolean;
+}) => (
+  <span
+    aria-hidden="true"
+    data-active={active || undefined}
+    className={cn(
+      "ml-auto flex h-4 min-w-4 shrink-0 items-center justify-center rounded-full",
+      "bg-primary px-xxs text-caption text-on-primary",
+      "data-[active=true]:bg-on-primary data-[active=true]:text-primary",
+    )}
+  >
+    {badgeText(badge)}
+  </span>
+);
+
+/**
+ * The leading glyph plus, while the rail is folded, a dot on its top corner.
+ * The folded rail has no room for a pill, so the dot carries the signal and the
+ * count lives in the row's accessible name.
+ */
+const railGlyph = (item: SidebarDesktopNavItem, folded: boolean) => (
+  <span className="relative inline-flex shrink-0 items-center">
+    {glyph(item.icon, 16, 1.75)}
+    {folded && hasBadge(item.badge) ? (
+      <span
+        aria-hidden="true"
+        className={cn(
+          "pointer-events-none absolute -right-xxs -top-xxs size-2 rounded-full",
+          "bg-primary",
+          "group-data-[active=true]:bg-on-primary",
+        )}
+      />
+    ) : null}
+  </span>
+);
+
 /** The visible label, kept in the tree as an accessible name while folded. */
 const RowLabel = ({
   folded,
@@ -170,7 +255,7 @@ const RowLabel = ({
  */
 const railRowClass = (active: boolean, folded: boolean) =>
   cn(
-    "flex w-full cursor-pointer items-center rounded-lg border-0 bg-transparent",
+    "group flex w-full cursor-pointer items-center rounded-lg border-0 bg-transparent",
     "text-body-md transition duration-150 ease-out",
     "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-focus-blue",
     "focus-visible:ring-inset",
@@ -201,6 +286,10 @@ interface PanelBox {
  * width and the labels change, so the item order and the active row survive the
  * fold.
  *
+ * A destination may carry a count: unfolded it reads as a pill after the label,
+ * folded it becomes a dot on the glyph, and either way the number is part of the
+ * row's accessible name. Nothing is painted when the count is absent or zero.
+ *
  * The rail fills the height of its parent (`h-full`), so a one-viewport shell
  * (`md:sticky md:top-0 md:h-dvh`) is all the sizing it needs. The header, the
  * account switcher and the footer stay pinned; only the destination list
@@ -606,6 +695,7 @@ export const SidebarDesktop = React.forwardRef<HTMLElement, SidebarDesktopProps>
           >
             {navItems.map((item) => {
               const active = item.id === activeId;
+              const badged = hasBadge(item.badge);
 
               if (!item.children?.length) {
                 return (
@@ -614,11 +704,19 @@ export const SidebarDesktop = React.forwardRef<HTMLElement, SidebarDesktopProps>
                     href={item.href ?? `#${item.id}`}
                     onClick={navigate({ id: item.id, href: item.href })}
                     aria-current={active ? "page" : undefined}
-                    aria-label={isFolded ? item.label : undefined}
+                    data-active={active}
+                    aria-label={
+                      isFolded || badged
+                        ? rowAccessibleName(item.label, item.badge)
+                        : undefined
+                    }
                     className={railRowClass(active, isFolded)}
                   >
-                    {glyph(item.icon, 16, 1.75)}
+                    {railGlyph(item, isFolded)}
                     <RowLabel folded={isFolded}>{item.label}</RowLabel>
+                    {!isFolded && badged ? (
+                      <RailBadge badge={item.badge as number | string} active={active} />
+                    ) : null}
                   </a>
                 );
               }
@@ -633,21 +731,34 @@ export const SidebarDesktop = React.forwardRef<HTMLElement, SidebarDesktopProps>
                     size="rail"
                     aria-expanded={expanded}
                     aria-controls={subId}
-                    aria-label={isFolded ? item.label : undefined}
+                    aria-label={
+                      isFolded || badged
+                        ? rowAccessibleName(item.label, item.badge)
+                        : undefined
+                    }
                     data-active={active}
                     data-folded={isFolded}
                     onClick={() => toggleExpanded(item.id)}
-                    leadingIcon={glyph(item.icon, 16, 1.75)}
+                    className="group"
+                    leadingIcon={railGlyph(item, isFolded)}
                     trailingIcon={
                       isFolded ? undefined : (
-                        <span
-                          aria-hidden="true"
-                          className={cn(
-                            "flex shrink-0 items-center transition-transform duration-200 ease-out",
-                            expanded ? "rotate-180" : "rotate-0",
-                          )}
-                        >
-                          {glyph("chevron-down", 16, 2)}
+                        <span className="flex items-center gap-xs">
+                          {badged ? (
+                            <RailBadge
+                              badge={item.badge as number | string}
+                              active={active}
+                            />
+                          ) : null}
+                          <span
+                            aria-hidden="true"
+                            className={cn(
+                              "flex shrink-0 items-center transition-transform duration-200 ease-out",
+                              expanded ? "rotate-180" : "rotate-0",
+                            )}
+                          >
+                            {glyph("chevron-down", 16, 2)}
+                          </span>
                         </span>
                       )
                     }
@@ -713,6 +824,7 @@ export const SidebarDesktop = React.forwardRef<HTMLElement, SidebarDesktopProps>
           <nav aria-label="Secondary" className="mt-lg flex flex-col gap-xxs">
             {secondaryNav.map((item) => {
               const active = item.id === secondaryActiveId;
+              const badged = hasBadge(item.badge);
 
               return (
                 <a
@@ -720,11 +832,19 @@ export const SidebarDesktop = React.forwardRef<HTMLElement, SidebarDesktopProps>
                   href={item.href ?? `#${item.id}`}
                   onClick={navigate({ id: item.id, href: item.href })}
                   aria-current={active ? "page" : undefined}
-                  aria-label={isFolded ? item.label : undefined}
+                  data-active={active}
+                  aria-label={
+                    isFolded || badged
+                      ? rowAccessibleName(item.label, item.badge)
+                      : undefined
+                  }
                   className={railRowClass(active, isFolded)}
                 >
-                  {glyph(item.icon, 16, 1.75)}
+                  {railGlyph(item, isFolded)}
                   <RowLabel folded={isFolded}>{item.label}</RowLabel>
+                  {!isFolded && badged ? (
+                    <RailBadge badge={item.badge as number | string} active={active} />
+                  ) : null}
                 </a>
               );
             })}

package/src/atoms/SidebarMobile/SidebarMobile.tsx

@@ -33,6 +33,12 @@ export interface SidebarMobileNavItem {
   icon: IconName;
   /** Destination for a plain row. */
   href?: string;
+  /**
+   * Pending-work count painted as a pill after the label. A number (99+
+   * collapses), or a short string such as "New". Hidden when undefined, empty,
+   * or zero, and always part of the row's accessible name.
+   */
+  badge?: number | string;
   /** Nested rows: turns the parent into a disclosure. */
   children?: Array<{ id: string; label: string; href?: string }>;
 }
@@ -156,6 +162,64 @@ const glyph = (name: IconName, size = 18, strokeWidth = 1.75) => (
   <Icon name={name} size={size} strokeWidth={strokeWidth} style={{ color: "inherit" }} />
 );
 
+/** True when an item carries a count worth painting. Zero and empties hide. */
+const hasBadge = (badge?: number | string) => {
+  if (badge === undefined || badge === null) {
+    return false;
+  }
+  if (typeof badge === "number") {
+    return Number.isFinite(badge) && badge !== 0;
+  }
+  const trimmed = badge.trim();
+  return trimmed.length > 0 && trimmed !== "0";
+};
+
+/** The pill copy: numbers above 99 collapse so a row never reflows. */
+const badgeText = (badge: number | string) =>
+  typeof badge === "number"
+    ? badge > 99
+      ? "99+"
+      : String(badge)
+    : badge.trim();
+
+/**
+ * The row's accessible name. The count rides along as pending work, so the row
+ * announces "Tasks, 2 pending" instead of only its label.
+ */
+const rowAccessibleName = (label: string, badge?: number | string) => {
+  if (!hasBadge(badge)) {
+    return label;
+  }
+  return typeof badge === "number"
+    ? `${label}, ${badge} pending`
+    : `${label}, ${badgeText(badge as string)}`;
+};
+
+/**
+ * The count pill that follows a row's label. It wears the brand fill with
+ * inverse type on the light drawer, flipped to the inverse fill while the row
+ * itself is the selected brand block.
+ */
+const NavBadge = ({
+  badge,
+  active,
+}: {
+  badge: number | string;
+  active?: boolean;
+}) => (
+  <span
+    aria-hidden="true"
+    data-active={active || undefined}
+    className={cn(
+      "ml-auto flex h-4 min-w-4 shrink-0 items-center justify-center rounded-full",
+      "bg-primary px-xxs text-caption text-on-primary",
+      "data-[active=true]:bg-on-primary data-[active=true]:text-primary",
+    )}
+  >
+    {badgeText(badge)}
+  </span>
+);
+
 /**
  * A destination row in the drawer. A nav row spans the panel's gutter, so its
  * press is a tint rather than a scale — scaling would pull the fill away from
@@ -174,8 +238,8 @@ const rowClass = (active: boolean) =>
   );
 
 /** A nested destination: one step quieter and tighter than its parent, indented
- *  onto the parent's label by an invisible glyph-sized spacer rather than a
- *  second padding utility. */
+ * onto the parent's label by an invisible glyph-sized spacer rather than a
+ * second padding utility. */
 const subRowClass = cn(
   "flex min-h-7 w-full cursor-pointer items-center gap-md rounded-md px-md py-xxs",
   "text-body-sm text-body transition duration-150 ease-out",
@@ -203,6 +267,10 @@ const isModified = (event: React.MouseEvent) =>
  * profile row pinned to the foot of the panel. A row click closes the drawer, so
  * a routed navigation never leaves the panel hanging open behind the new page.
  *
+ * A destination may carry a count: it reads as a pill after the label, and the
+ * number is part of the row's accessible name. Nothing is painted when the
+ * count is absent or zero.
+ *
  * The panel stays mounted and travels with `translate-x`, so the close
  * animation is never skipped; it only drops out of the paint once it has
  * finished travelling, and nothing inside can be tabbed while it is off-canvas.
@@ -557,6 +625,7 @@ export const SidebarMobile = React.forwardRef<HTMLDivElement, SidebarMobileProps
                   <nav aria-label="Primary" className="mt-md flex flex-col gap-xxs">
                     {navItems.map((item) => {
                       const active = item.id === activeId;
+                      const badged = hasBadge(item.badge);
 
                       if (!item.children?.length) {
                         return (
@@ -565,10 +634,21 @@ export const SidebarMobile = React.forwardRef<HTMLDivElement, SidebarMobileProps
                             href={item.href ?? `#${item.id}`}
                             onClick={navigate({ id: item.id, href: item.href })}
                             aria-current={active ? "page" : undefined}
+                            aria-label={
+                              badged
+                                ? rowAccessibleName(item.label, item.badge)
+                                : undefined
+                            }
                             className={rowClass(active)}
                           >
                             {glyph(item.icon, 18, 1.75)}
                             <span className="truncate">{item.label}</span>
+                            {badged ? (
+                              <NavBadge
+                                badge={item.badge as number | string}
+                                active={active}
+                              />
+                            ) : null}
                           </a>
                         );
                       }
@@ -583,18 +663,32 @@ export const SidebarMobile = React.forwardRef<HTMLDivElement, SidebarMobileProps
                             size="rail"
                             aria-expanded={expanded}
                             aria-controls={subId}
+                            aria-label={
+                              badged
+                                ? rowAccessibleName(item.label, item.badge)
+                                : undefined
+                            }
                             data-active={active}
                             onClick={() => toggleExpanded(item.id)}
                             className="px-md"
                             leadingIcon={glyph(item.icon, 18, 1.75)}
                             trailingIcon={
-                              <span
-                                className={cn(
-                                  "flex shrink-0 items-center transition-transform duration-200 ease-out",
-                                  expanded ? "rotate-180" : "rotate-0",
-                                )}
-                              >
-                                {glyph("chevron-down", 18, 2)}
+                              <span className="flex items-center gap-xs">
+                                {badged ? (
+                                  <NavBadge
+                                    badge={item.badge as number | string}
+                                    active={active}
+                                  />
+                                ) : null}
+                                <span
+                                  aria-hidden="true"
+                                  className={cn(
+                                    "flex shrink-0 items-center transition-transform duration-200 ease-out",
+                                    expanded ? "rotate-180" : "rotate-0",
+                                  )}
+                                >
+                                  {glyph("chevron-down", 18, 2)}
+                                </span>
                               </span>
                             }
                           >
@@ -659,6 +753,7 @@ export const SidebarMobile = React.forwardRef<HTMLDivElement, SidebarMobileProps
                   <nav aria-label="Secondary" className="flex flex-col gap-xxs">
                     {secondaryNav.map((item) => {
                       const active = item.id === secondaryActiveId;
+                      const badged = hasBadge(item.badge);
 
                       return (
                         <a
@@ -666,10 +761,21 @@ export const SidebarMobile = React.forwardRef<HTMLDivElement, SidebarMobileProps
                           href={item.href ?? `#${item.id}`}
                           onClick={navigate({ id: item.id, href: item.href })}
                           aria-current={active ? "page" : undefined}
+                          aria-label={
+                            badged
+                              ? rowAccessibleName(item.label, item.badge)
+                              : undefined
+                          }
                           className={rowClass(active)}
                         >
                           {glyph(item.icon, 18, 1.75)}
                           <span className="truncate">{item.label}</span>
+                          {badged ? (
+                            <NavBadge
+                              badge={item.badge as number | string}
+                              active={active}
+                            />
+                          ) : null}
                         </a>
                       );
                     })}