@rahdar/plugin-sdk 2026.10.66 → 2026.11.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rahdar/plugin-sdk",
-  "version": "2026.10.66",
+  "version": "2026.11.0",
   "description": "Build the UI of a Rahdar plugin: typings for the Rahdar APIs a plugin may use, and a Vite preset.",
   "license": "Apache-2.0",
   "repository": {

package/types/kernel/feature.d.ts

@@ -42,6 +42,11 @@ export interface NavContribution {
      * `/clusters/$clusterId/<system>/`, which another system's cluster answers with the not-found page.
      */
     system?: string;
+    /**
+     * The resource class (`CONNECTION`) the view lists. The navigation offers the view only on a cluster whose
+     * system has a kind of that class, so a system without connections has no empty Connections page.
+     */
+    resourceClass?: string;
     /**
      * The permission the view reads with. Without it the entry stays visible and disabled,
      * and says why; the server enforces it regardless.

package/types/kernel/keyboard/useKeySequences.d.ts

@@ -7,7 +7,7 @@ import { type NavContribution } from '../feature.ts';
 export declare function viewHotkeys(features: {
     id: string;
     nav?: NavContribution[];
-}[], systemId?: string): Map<string, NavContribution>;
+}[], systemId?: string, classes?: readonly string[]): Map<string, NavContribution>;
 /**
  * The single-key shortcuts (ADR-0109), as one document listener mounted by the shell:
  * `g` then a view's letter goes to that view of the open cluster, `?` opens the list of shortcuts,

package/types/kernel/registry.d.ts

@@ -5,9 +5,14 @@ export interface NavGroup {
     label: string;
     items: NavContribution[];
 }
+/**
+ * Whether a cluster is offered a view: a system-only view only on a cluster that runs that system
+ * (`systemId`), and a view of a resource class only where the system has a kind of that class (`classes`).
+ */
+export declare function offeredOn(item: NavContribution, systemId?: string, classes?: readonly string[]): boolean;
 /**
  * The features' views under the kernel's groups (ADR-0070): groups in their fixed order, views in
- * their declared order, and a group none of the features contributes to left out. A system-only view is
- * listed only for a cluster that runs that system (`systemId`).
+ * their declared order, and a group none of the features contributes to left out. A view is listed only for a
+ * cluster it is offered on ({@link offeredOn}).
  */
-export declare function navGroups(features: RahdarFeature[], systemId?: string): NavGroup[];
+export declare function navGroups(features: RahdarFeature[], systemId?: string, classes?: readonly string[]): NavGroup[];

package/types/kernel/slots.d.ts

@@ -187,8 +187,8 @@ export interface SlotContribution<P> {
      */
     group?: string;
     /**
-     * `routes.tabs` only: the id of the broker system the tab is for (`artemis`). The tab is listed only on a
-     * cluster that runs that system.
+     * The id of the broker system the contribution is for (`artemis`). A cluster-scoped slot lists it only on a
+     * cluster that runs that system (`useClusterSlot`); without it the contribution applies to every system.
      */
     system?: string;
     /** `*.actions` only: the menu section the item is listed under. */