@s2script/sdk 0.24.0 → 0.25.1

package/menu.d.ts

@@ -80,8 +80,12 @@ export declare class Menu {
   display(slot: number, seconds?: number): void;
   /** Close an open menu for `slot` early. */
   close(slot: number): void;
-  /** Register a display backend under a MenuStyle value (used by the CS2 center renderer). */
-  static registerRenderer(name: string, renderer: MenuRenderer): void;
+  /**
+   * Register a display backend under a MenuStyle value (used by the CS2 center renderer).
+   * Returns the previous renderer, or undefined if none was registered, so a replacement can
+   * delegate to the previous backend when its own display is unavailable.
+   */
+  static registerRenderer(name: string, renderer: MenuRenderer): MenuRenderer | undefined;
 }
 
 /** A live display of one menu to one slot, passed to a {@link MenuRenderer}. Owns the page/cursor state and exposes the input verbs a renderer drives. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@s2script/sdk",
-  "version": "0.24.0",
+  "version": "0.25.1",
   "license": "MIT OR Apache-2.0",
   "description": "s2script SDK — the builtin capability types (imported as @s2script/sdk/entity, …) plus the `s2s` CLI for building Source 2 / CS2 plugins.",
   "type": "module",

package/plugin.d.ts

@@ -12,7 +12,7 @@ import type { EntityRef, OutputEvent } from "./entity";
 import type { CommandHandler } from "./commands";
 import type { Config } from "./config";
 import type { PublishHandle } from "./interfaces";
-import type { TopMenuItem } from "./topmenu";
+import type { TopMenuItem, TopMenuTab } from "./topmenu";
 import type { PrecacheContext } from "./sound";
 import type { UserCmdView } from "./usercmd";
 
@@ -133,9 +133,14 @@ export interface CtxConfig {
 }
 /** TopMenu (adminmenu) contribution on this plugin's load-scope ({@link PluginContext.topmenu}). */
 export interface CtxTopMenu {
-  /** Add (or reuse) a top-level menu category. */
+  /** Add (or reuse) a top-level menu category. Same as {@link CtxTopMenu.addTab} with `id === title`. */
   addCategory(name: string): void;
-  /** Add an item under an existing category. */
+  /**
+   * Declare this plugin's dashboard tab. The hub (`sm_admin` / `sm_menu`) paints one tab per
+   * distinct id that still has a visible item. Call before {@link CtxTopMenu.addItem}.
+   */
+  addTab(tab: TopMenuTab): void;
+  /** Add an item under a tab id (or a legacy shared category name). */
   addItem(category: string, item: TopMenuItem): void;
 }
 

package/topmenu.d.ts

@@ -2,6 +2,17 @@
 
 export type TopMenuSheet = "admin" | "menu";
 
+/**
+ * A plugin-owned dashboard tab. `id` is the {@link TopMenuItem} grouping key (`addItem` first
+ * argument); `title` is what the hub paints on the tab bar.
+ */
+export interface TopMenuTab {
+  /** Stable id, e.g. `"playercommands"`. A duplicate id updates the title. */
+  id: string;
+  /** Tab label. Defaults to {@link TopMenuTab.id}. */
+  title?: string;
+}
+
 /** A single registered top-menu entry (an admin command surfaced in the adminmenu). */
 export interface TopMenuItem {
   /** Plugin-namespaced unique id, e.g. "playercommands:slap". A duplicate id replaces. */
@@ -17,9 +28,11 @@ export interface TopMenuItem {
 }
 /** A handler-free copy of the whole registry — what a menu renderer reads to build the display. */
 export interface TopMenuSnapshot {
-  /** All category names, in registration order. */
+  /** Tab ids, in registration order. Same sequence as {@link TopMenuSnapshot.tabs}. */
   categories: string[];
-  /** Every registered item's metadata (no `onSelect`), tagged with its category. */
+  /** Dashboard tabs with display titles. `addCategory(name)` is `{ id: name, title: name }`. */
+  tabs: { id: string; title: string }[];
+  /** Every registered item's metadata (no `onSelect`), tagged with its tab id (`category`). */
   items: { id: string; category: string; name: string; flags: number; sheets: TopMenuSheet[] }[];
 }
 /**