@openvcs/sdk 0.2.8 → 0.2.10

package/lib/runtime/index.d.ts

@@ -8,5 +8,7 @@ export { createHost } from './host';
 export { bootstrapPluginModule, createRegisteredPluginRuntime, } from './registration';
 export { VcsDelegateBase } from './vcs-delegate-base';
 export type { VcsDelegateAssignments } from './vcs-delegate-metadata';
+export { getMenu, getOrCreateMenu, createMenu, addMenuItem, addMenuSeparator, removeMenu, hideMenu, showMenu, registerAction, invoke, notify, } from './menu';
+export type { MenuHandle } from './menu';
 /** Starts a previously created plugin runtime on process stdio. */
 export declare function startPluginRuntime(runtime: PluginRuntime, transport?: PluginRuntimeTransport): void;

package/lib/runtime/index.js

@@ -2,7 +2,7 @@
 // Copyright © 2025-2026 OpenVCS Contributors
 // SPDX-License-Identifier: GPL-3.0-or-later
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.VcsDelegateBase = exports.createRegisteredPluginRuntime = exports.bootstrapPluginModule = exports.createHost = exports.createPluginRuntime = exports.pluginError = exports.isPluginFailure = exports.createRuntimeDispatcher = exports.createDefaultPluginDelegates = void 0;
+exports.notify = exports.invoke = exports.registerAction = exports.showMenu = exports.hideMenu = exports.removeMenu = exports.addMenuSeparator = exports.addMenuItem = exports.createMenu = exports.getOrCreateMenu = exports.getMenu = exports.VcsDelegateBase = exports.createRegisteredPluginRuntime = exports.bootstrapPluginModule = exports.createHost = exports.createPluginRuntime = exports.pluginError = exports.isPluginFailure = exports.createRuntimeDispatcher = exports.createDefaultPluginDelegates = void 0;
 exports.startPluginRuntime = startPluginRuntime;
 var dispatcher_1 = require("./dispatcher");
 Object.defineProperty(exports, "createDefaultPluginDelegates", { enumerable: true, get: function () { return dispatcher_1.createDefaultPluginDelegates; } });
@@ -19,6 +19,18 @@ Object.defineProperty(exports, "bootstrapPluginModule", { enumerable: true, get:
 Object.defineProperty(exports, "createRegisteredPluginRuntime", { enumerable: true, get: function () { return registration_1.createRegisteredPluginRuntime; } });
 var vcs_delegate_base_1 = require("./vcs-delegate-base");
 Object.defineProperty(exports, "VcsDelegateBase", { enumerable: true, get: function () { return vcs_delegate_base_1.VcsDelegateBase; } });
+var menu_1 = require("./menu");
+Object.defineProperty(exports, "getMenu", { enumerable: true, get: function () { return menu_1.getMenu; } });
+Object.defineProperty(exports, "getOrCreateMenu", { enumerable: true, get: function () { return menu_1.getOrCreateMenu; } });
+Object.defineProperty(exports, "createMenu", { enumerable: true, get: function () { return menu_1.createMenu; } });
+Object.defineProperty(exports, "addMenuItem", { enumerable: true, get: function () { return menu_1.addMenuItem; } });
+Object.defineProperty(exports, "addMenuSeparator", { enumerable: true, get: function () { return menu_1.addMenuSeparator; } });
+Object.defineProperty(exports, "removeMenu", { enumerable: true, get: function () { return menu_1.removeMenu; } });
+Object.defineProperty(exports, "hideMenu", { enumerable: true, get: function () { return menu_1.hideMenu; } });
+Object.defineProperty(exports, "showMenu", { enumerable: true, get: function () { return menu_1.showMenu; } });
+Object.defineProperty(exports, "registerAction", { enumerable: true, get: function () { return menu_1.registerAction; } });
+Object.defineProperty(exports, "invoke", { enumerable: true, get: function () { return menu_1.invoke; } });
+Object.defineProperty(exports, "notify", { enumerable: true, get: function () { return menu_1.notify; } });
 /** Starts a previously created plugin runtime on process stdio. */
 function startPluginRuntime(runtime, transport) {
     runtime.start(transport);

package/lib/runtime/menu.d.ts

@@ -0,0 +1,25 @@
+import type { MenubarItem } from '../types/menubar.js';
+type MenubarMenuOptions = {
+    before?: string;
+    after?: string;
+};
+export interface MenuHandle {
+    id: string;
+    addItem(item: MenubarItem): void;
+    addSeparator(beforeAction?: string): void;
+    removeItem(actionId: string): void;
+    hideItem(actionId: string): void;
+    showItem(actionId: string): void;
+}
+export declare function getMenu(menuId: string): MenuHandle | null;
+export declare function getOrCreateMenu(menuId: string, label: string): MenuHandle | null;
+export declare function createMenu(menuId: string, label: string, options?: MenubarMenuOptions): MenuHandle | null;
+export declare function addMenuItem(menuId: string, item: MenubarItem): void;
+export declare function addMenuSeparator(menuId: string, beforeAction?: string): void;
+export declare function removeMenu(menuId: string): void;
+export declare function hideMenu(menuId: string): void;
+export declare function showMenu(menuId: string): void;
+export declare function registerAction(id: string, handler: (...args: unknown[]) => unknown): void;
+export declare function invoke<T = unknown>(cmd: string, args?: unknown): Promise<T>;
+export declare function notify(msg: string): void;
+export {};

package/lib/runtime/menu.js

@@ -0,0 +1,76 @@
+"use strict";
+// Copyright © 2025-2026 OpenVCS Contributors
+// SPDX-License-Identifier: GPL-3.0-or-later
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getMenu = getMenu;
+exports.getOrCreateMenu = getOrCreateMenu;
+exports.createMenu = createMenu;
+exports.addMenuItem = addMenuItem;
+exports.addMenuSeparator = addMenuSeparator;
+exports.removeMenu = removeMenu;
+exports.hideMenu = hideMenu;
+exports.showMenu = showMenu;
+exports.registerAction = registerAction;
+exports.invoke = invoke;
+exports.notify = notify;
+function getOpenVCS() {
+    return globalThis.OpenVCS;
+}
+function castMenuHandle(menu) {
+    if (!menu)
+        return null;
+    return menu;
+}
+function getMenu(menuId) {
+    const openvcs = getOpenVCS();
+    if (!openvcs?.menus)
+        return null;
+    return castMenuHandle(openvcs.menus.get(menuId));
+}
+function getOrCreateMenu(menuId, label) {
+    const openvcs = getOpenVCS();
+    if (!openvcs?.menus)
+        return null;
+    return castMenuHandle(openvcs.menus.getOrCreate(menuId, label));
+}
+function createMenu(menuId, label, options) {
+    const openvcs = getOpenVCS();
+    if (!openvcs?.menus)
+        return null;
+    return castMenuHandle(openvcs.menus.create(menuId, label, options));
+}
+function addMenuItem(menuId, item) {
+    const openvcs = getOpenVCS();
+    openvcs?.menus?.addMenuItem(menuId, item);
+}
+function addMenuSeparator(menuId, beforeAction) {
+    const openvcs = getOpenVCS();
+    openvcs?.menus?.addMenuSeparator(menuId, beforeAction);
+}
+function removeMenu(menuId) {
+    const openvcs = getOpenVCS();
+    openvcs?.menus?.remove(menuId);
+}
+function hideMenu(menuId) {
+    const openvcs = getOpenVCS();
+    openvcs?.menus?.hide(menuId);
+}
+function showMenu(menuId) {
+    const openvcs = getOpenVCS();
+    openvcs?.menus?.show(menuId);
+}
+function registerAction(id, handler) {
+    const openvcs = getOpenVCS();
+    openvcs?.registerAction(id, handler);
+}
+function invoke(cmd, args) {
+    const openvcs = getOpenVCS();
+    if (!openvcs) {
+        return Promise.reject(new Error('OpenVCS not available'));
+    }
+    return openvcs.invoke(cmd, args);
+}
+function notify(msg) {
+    const openvcs = getOpenVCS();
+    openvcs?.notify(msg);
+}

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.10",
   "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/runtime/index.ts

@@ -28,6 +28,20 @@ export {
 } from './registration';
 export { VcsDelegateBase } from './vcs-delegate-base';
 export type { VcsDelegateAssignments } from './vcs-delegate-metadata';
+export {
+  getMenu,
+  getOrCreateMenu,
+  createMenu,
+  addMenuItem,
+  addMenuSeparator,
+  removeMenu,
+  hideMenu,
+  showMenu,
+  registerAction,
+  invoke,
+  notify,
+} from './menu';
+export type { MenuHandle } from './menu';
 
 /** Starts a previously created plugin runtime on process stdio. */
 export function startPluginRuntime(

package/src/lib/runtime/menu.ts

@@ -0,0 +1,103 @@
+// Copyright © 2025-2026 OpenVCS Contributors
+// SPDX-License-Identifier: GPL-3.0-or-later
+
+import type { MenubarItem } from '../types/menubar.js';
+
+type MenubarMenuOptions = { before?: string; after?: string };
+
+type OpenVCSGlobal = typeof globalThis & {
+  OpenVCS?: {
+    menus?: {
+      get(menuId: string): unknown;
+      getOrCreate(menuId: string, label: string): unknown;
+      create(menuId: string, label: string, options?: MenubarMenuOptions): unknown;
+      addMenuItem(menuId: string, item: MenubarItem): void;
+      addMenuSeparator(menuId: string, beforeAction?: string): void;
+      remove(menuId: string): void;
+      hide(menuId: string): void;
+      show(menuId: string): void;
+    };
+    registerAction(id: string, handler: (...args: unknown[]) => unknown): void;
+    invoke<T = unknown>(cmd: string, args?: unknown): Promise<T>;
+    notify(msg: string): void;
+  };
+};
+
+function getOpenVCS() {
+  return (globalThis as OpenVCSGlobal).OpenVCS;
+}
+
+export interface MenuHandle {
+  id: string;
+  addItem(item: MenubarItem): void;
+  addSeparator(beforeAction?: string): void;
+  removeItem(actionId: string): void;
+  hideItem(actionId: string): void;
+  showItem(actionId: string): void;
+}
+
+function castMenuHandle(menu: unknown): MenuHandle | null {
+  if (!menu) return null;
+  return menu as MenuHandle;
+}
+
+export function getMenu(menuId: string): MenuHandle | null {
+  const openvcs = getOpenVCS();
+  if (!openvcs?.menus) return null;
+  return castMenuHandle(openvcs.menus.get(menuId));
+}
+
+export function getOrCreateMenu(menuId: string, label: string): MenuHandle | null {
+  const openvcs = getOpenVCS();
+  if (!openvcs?.menus) return null;
+  return castMenuHandle(openvcs.menus.getOrCreate(menuId, label));
+}
+
+export function createMenu(menuId: string, label: string, options?: MenubarMenuOptions): MenuHandle | null {
+  const openvcs = getOpenVCS();
+  if (!openvcs?.menus) return null;
+  return castMenuHandle(openvcs.menus.create(menuId, label, options));
+}
+
+export function addMenuItem(menuId: string, item: MenubarItem): void {
+  const openvcs = getOpenVCS();
+  openvcs?.menus?.addMenuItem(menuId, item);
+}
+
+export function addMenuSeparator(menuId: string, beforeAction?: string): void {
+  const openvcs = getOpenVCS();
+  openvcs?.menus?.addMenuSeparator(menuId, beforeAction);
+}
+
+export function removeMenu(menuId: string): void {
+  const openvcs = getOpenVCS();
+  openvcs?.menus?.remove(menuId);
+}
+
+export function hideMenu(menuId: string): void {
+  const openvcs = getOpenVCS();
+  openvcs?.menus?.hide(menuId);
+}
+
+export function showMenu(menuId: string): void {
+  const openvcs = getOpenVCS();
+  openvcs?.menus?.show(menuId);
+}
+
+export function registerAction(id: string, handler: (...args: unknown[]) => unknown): void {
+  const openvcs = getOpenVCS();
+  openvcs?.registerAction(id, handler);
+}
+
+export function invoke<T = unknown>(cmd: string, args?: unknown): Promise<T> {
+  const openvcs = getOpenVCS();
+  if (!openvcs) {
+    return Promise.reject(new Error('OpenVCS not available'));
+  }
+  return openvcs.invoke(cmd, args);
+}
+
+export function notify(msg: string): void {
+  const openvcs = getOpenVCS();
+  openvcs?.notify(msg);
+}

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;
+}