@openvcs/sdk 0.2.8 → 0.2.9

package/lib/types/index.d.ts

@@ -1,4 +1,5 @@
 export * from './host';
+export * from './menubar';
 export * from './plugin';
 export * from './protocol';
 export * from './vcs';

package/lib/types/index.js

@@ -17,6 +17,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./host"), exports);
+__exportStar(require("./menubar"), exports);
 __exportStar(require("./plugin"), exports);
 __exportStar(require("./protocol"), exports);
 __exportStar(require("./vcs"), exports);

package/lib/types/menubar.d.ts

@@ -0,0 +1,46 @@
+/** API for manipulating top-level application menus. */
+export interface MenubarManager {
+    /** Gets a menu by ID (e.g., 'file', 'repository', 'help'). Returns null if not found. */
+    get(menuId: string): MenubarMenu | null;
+    /** Gets a menu by ID, creating it if it doesn't exist. */
+    getOrCreate(menuId: string, label: string): MenubarMenu;
+    /** Creates a new menu at the specified position. */
+    create(menuId: string, label: string, options?: {
+        before?: string;
+        after?: string;
+    }): MenubarMenu;
+    /** Removes a menu entirely. */
+    remove(menuId: string): void;
+    /** Hides a menu (visibility: hidden). */
+    hide(menuId: string): void;
+    /** Shows a hidden menu. */
+    show(menuId: string): void;
+}
+/** Handle for manipulating a specific menu. */
+export interface MenubarMenu {
+    /** Menu ID. */
+    id: string;
+    /** Adds an item to this menu. */
+    addItem(item: MenubarItem): void;
+    /** Adds a separator to this menu. */
+    addSeparator(beforeAction?: string): void;
+    /** Removes an item by action ID. */
+    removeItem(actionId: string): void;
+    /** Hides an item by action ID. */
+    hideItem(actionId: string): void;
+    /** Shows a hidden item. */
+    showItem(actionId: string): void;
+}
+/** Descriptor for a menu item. */
+export interface MenubarItem {
+    /** Display label. */
+    label: string;
+    /** Action ID (plugin must register handler separately). */
+    action: string;
+    /** Optional tooltip. */
+    title?: string;
+    /** Insert before this action ID. */
+    before?: string;
+    /** Insert after this action ID. */
+    after?: string;
+}

package/lib/types/menubar.js

@@ -0,0 +1,4 @@
+"use strict";
+// Copyright © 2025-2026 OpenVCS Contributors
+// SPDX-License-Identifier: GPL-3.0-or-later
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openvcs/sdk",
-  "version": "0.2.8",
+  "version": "0.2.9",
   "description": "OpenVCS SDK CLI for plugin scaffolding and .ovcsp tar.gz packaging",
   "license": "GPL-3.0-or-later",
   "homepage": "https://openvcs.app/",

package/src/lib/types/index.ts

@@ -2,6 +2,7 @@
 // SPDX-License-Identifier: GPL-3.0-or-later
 
 export * from './host';
+export * from './menubar';
 export * from './plugin';
 export * from './protocol';
 export * from './vcs';

package/src/lib/types/menubar.ts

@@ -0,0 +1,48 @@
+// Copyright © 2025-2026 OpenVCS Contributors
+// SPDX-License-Identifier: GPL-3.0-or-later
+
+/** API for manipulating top-level application menus. */
+export interface MenubarManager {
+  /** Gets a menu by ID (e.g., 'file', 'repository', 'help'). Returns null if not found. */
+  get(menuId: string): MenubarMenu | null;
+  /** Gets a menu by ID, creating it if it doesn't exist. */
+  getOrCreate(menuId: string, label: string): MenubarMenu;
+  /** Creates a new menu at the specified position. */
+  create(menuId: string, label: string, options?: { before?: string; after?: string }): MenubarMenu;
+  /** Removes a menu entirely. */
+  remove(menuId: string): void;
+  /** Hides a menu (visibility: hidden). */
+  hide(menuId: string): void;
+  /** Shows a hidden menu. */
+  show(menuId: string): void;
+}
+
+/** Handle for manipulating a specific menu. */
+export interface MenubarMenu {
+  /** Menu ID. */
+  id: string;
+  /** Adds an item to this menu. */
+  addItem(item: MenubarItem): void;
+  /** Adds a separator to this menu. */
+  addSeparator(beforeAction?: string): void;
+  /** Removes an item by action ID. */
+  removeItem(actionId: string): void;
+  /** Hides an item by action ID. */
+  hideItem(actionId: string): void;
+  /** Shows a hidden item. */
+  showItem(actionId: string): void;
+}
+
+/** Descriptor for a menu item. */
+export interface MenubarItem {
+  /** Display label. */
+  label: string;
+  /** Action ID (plugin must register handler separately). */
+  action: string;
+  /** Optional tooltip. */
+  title?: string;
+  /** Insert before this action ID. */
+  before?: string;
+  /** Insert after this action ID. */
+  after?: string;
+}