@brendanbank/atrium-host-types 0.15.2 → 0.16.0

package/README.md

@@ -32,8 +32,8 @@ your `.npmrc`, delete it — npmjs.org is the default registry.
 
 ## Versioning
 
-The package version tracks atrium's image version. Pin `^0.15` for
-"compatible with atrium 0.15.x"; bump together with the atrium image
+The package version tracks atrium's image version. Pin `^0.16` for
+"compatible with atrium 0.16.x"; bump together with the atrium image
 to pick up new registry slots. New slots land as **optional** members
 on `AtriumRegistry` first so a host that hasn't bumped yet still
 type-checks.

package/dist/index.d.ts

@@ -99,6 +99,13 @@ export interface NavItem {
     condition?: (ctx: {
         me: UserContext | null;
     }) => boolean;
+    /** Optional sort key. Lower values render higher in the sidebar.
+     *  Items without `order` keep insertion order, sorted **after** every
+     *  item that has one. Atrium's built-in nav items use 100/200/300
+     *  (Home, Notifications, Admin) so a host can pick a number to
+     *  interleave with them — e.g. `order: 250` to land between
+     *  Notifications and Admin. Available since atrium 0.16. */
+    order?: number;
 }
 export interface AdminTab {
     key: string;
@@ -113,6 +120,12 @@ export interface AdminTab {
     render?: () => ReactElement;
     /** @deprecated Pass `render: () => element` instead. */
     element?: ReactElement;
+    /** Optional sort key. Lower values render further left. Items
+     *  without `order` keep registration order, sorted **after** every
+     *  item that has one. Atrium's built-in tabs use 100..900 in steps
+     *  of 100; a host tab with `order: 750` would slot between Email
+     *  templates (700) and Reminders (800). Available since atrium 0.16. */
+    order?: number;
 }
 /** Insertion slot inside `ProfilePage`'s vertical card stack. Default
  *  `'after-roles'` — the natural place for extra preferences. */
@@ -127,6 +140,11 @@ export interface ProfileItem {
         me: UserContext;
     }) => boolean;
     render: () => ReactElement;
+    /** Optional sort key within the chosen slot. Lower values render
+     *  earlier; items without `order` keep registration order and land
+     *  after items that have one. Slots are independent — the sort runs
+     *  per-slot. Available since atrium 0.16. */
+    order?: number;
 }
 /** Per-kind renderer for a notification row. Atrium emits `{kind,
  *  payload}` rows but ships no built-in formatting — host apps register

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brendanbank/atrium-host-types",
-  "version": "0.15.2",
+  "version": "0.16.0",
   "description": "TypeScript declarations for the atrium host-extension contract: AtriumRegistry, UserContext, AdminUserRow, AtriumNotification, AtriumEvent. Source-of-truth shapes a host bundle types against, kept in sync with atrium's published image major.minor.",
   "license": "BSD-2-Clause",
   "type": "module",