@cosxai/ui 0.10.2 → 0.10.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosxai/ui",
-  "version": "0.10.2",
+  "version": "0.10.3",
   "description": "COSX design system — React 19 component primitives shared across product-meta and other consumers",
   "license": "UNLICENSED",
   "type": "module",

package/src/actionbar/ActionBar.tsx

@@ -209,8 +209,19 @@ export function ActionBar({
     });
   }, [storageKey]);
   const hasAdminItems = useMemo(() => items.some((it) => it.adminOnly === true), [items]);
+  // Filter semantics:
+  //   admin OFF → hide items marked adminOnly (the toggle would reveal them)
+  //   admin ON  → hide items marked hiddenInAdmin (page opted them out of admin view)
+  // Together, adminOnly + hiddenInAdmin let pages choose:
+  //   - additive: normal items unmarked → visible in both modes;
+  //     admin items marked adminOnly → visible only in admin
+  //   - exclusive: normal items marked hiddenInAdmin → hidden in admin;
+  //     admin items marked adminOnly → visible only in admin
   const visibleItems = useMemo(
-    () => (adminMode ? items : items.filter((it) => it.adminOnly !== true)),
+    () =>
+      adminMode
+        ? items.filter((it) => it.hiddenInAdmin !== true)
+        : items.filter((it) => it.adminOnly !== true),
     [items, adminMode],
   );
 

package/src/actionbar/types.ts

@@ -60,6 +60,18 @@ export interface ActionBarItem {
   // (or an equivalent gate) === true. The kit does not check
   // permissions; it only handles the toggle UX.
   adminOnly?: boolean;
+  // Marks a normally-visible item as hidden when admin mode is on.
+  // Symmetric counterpart to `adminOnly`: pages that want an
+  // exclusive "different toolset" UX (e.g. Share disappears in favour
+  // of Manage Share + Activity + History) mark their regular items
+  // hiddenInAdmin=true so they clear when the toggle flips on.
+  // Pages that want additive layering (regular items stay + admin
+  // items appear alongside) just leave this unset.
+  //
+  // Per-item because different pages within the same app want
+  // different behaviour: block_doc viewer wants exclusive; a
+  // hypothetical PDF admin surface might want additive.
+  hiddenInAdmin?: boolean;
 }
 
 // Category definition — declared at the provider level. Drives