@openvcs/sdk 0.2.7 → 0.2.9

package/lib/build.d.ts

@@ -12,6 +12,8 @@ export interface ManifestInfo {
 }
 /** Returns the npm executable name for the current platform. */
 export declare function npmExecutable(): string;
+/** Returns whether a command must be launched via the Windows shell. */
+export declare function shouldUseWindowsShell(program: string): boolean;
 /** Formats help text for the build command. */
 export declare function buildUsage(commandName?: string): string;
 /** Parses `openvcs build` arguments. */

package/lib/build.js

@@ -3,6 +3,7 @@
 // SPDX-License-Identifier: GPL-3.0-or-later
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.npmExecutable = npmExecutable;
+exports.shouldUseWindowsShell = shouldUseWindowsShell;
 exports.buildUsage = buildUsage;
 exports.parseBuildArgs = parseBuildArgs;
 exports.readManifest = readManifest;
@@ -21,7 +22,15 @@ const fs_utils_1 = require("./fs-utils");
 const AUTHORED_PLUGIN_MODULE_BASENAME = "plugin.js";
 /** Returns the npm executable name for the current platform. */
 function npmExecutable() {
-    return process.platform === "win32" ? "npm.cmd" : "npm";
+    return "npm";
+}
+/** Returns whether a command must be launched via the Windows shell. */
+function shouldUseWindowsShell(program) {
+    if (process.platform !== "win32") {
+        return false;
+    }
+    const normalized = program.toLowerCase();
+    return normalized === "npm" || normalized.endsWith(".cmd") || normalized.endsWith(".bat");
 }
 /** Formats help text for the build command. */
 function buildUsage(commandName = "openvcs") {
@@ -216,6 +225,7 @@ function runCommand(program, args, cwd, verbose) {
     }
     const result = (0, node_child_process_1.spawnSync)(program, args, {
         cwd,
+        shell: shouldUseWindowsShell(program),
         stdio: ["ignore", verbose ? "inherit" : "ignore", "inherit"],
     });
     if (result.error) {

package/lib/init.js

@@ -11,7 +11,14 @@ const node_process_1 = require("node:process");
 const node_child_process_1 = require("node:child_process");
 const packageJson = require("../package.json");
 function npmExecutable() {
-    return process.platform === "win32" ? "npm.cmd" : "npm";
+    return "npm";
+}
+function shouldUseWindowsShell(program) {
+    if (process.platform !== "win32") {
+        return false;
+    }
+    const normalized = program.toLowerCase();
+    return normalized === "npm" || normalized.endsWith(".cmd") || normalized.endsWith(".bat");
 }
 function initUsage(commandName = "openvcs") {
     return `Usage: ${commandName} init [--theme] [target-dir]\n\nOptions:\n  --theme                Start with a theme-only plugin template\n`;
@@ -165,6 +172,7 @@ async function collectAnswers({ forceTheme, targetHint }, promptDriver = createR
 function runNpmInstall(targetDir) {
     const result = (0, node_child_process_1.spawnSync)(npmExecutable(), ["install"], {
         cwd: targetDir,
+        shell: shouldUseWindowsShell(npmExecutable()),
         stdio: "inherit",
     });
     if (result.error) {

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.7",
+  "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/build.ts

@@ -36,7 +36,17 @@ const AUTHORED_PLUGIN_MODULE_BASENAME = "plugin.js";
 
 /** Returns the npm executable name for the current platform. */
 export function npmExecutable(): string {
-  return process.platform === "win32" ? "npm.cmd" : "npm";
+  return "npm";
+}
+
+/** Returns whether a command must be launched via the Windows shell. */
+export function shouldUseWindowsShell(program: string): boolean {
+  if (process.platform !== "win32") {
+    return false;
+  }
+
+  const normalized = program.toLowerCase();
+  return normalized === "npm" || normalized.endsWith(".cmd") || normalized.endsWith(".bat");
 }
 
 /** Formats help text for the build command. */
@@ -271,6 +281,7 @@ export function runCommand(program: string, args: string[], cwd: string, verbose
 
   const result = spawnSync(program, args, {
     cwd,
+    shell: shouldUseWindowsShell(program),
     stdio: ["ignore", verbose ? "inherit" : "ignore", "inherit"],
   }) as CommandResult;
 

package/src/lib/init.ts

@@ -34,7 +34,16 @@ interface InitCommandError {
 }
 
 function npmExecutable(): string {
-  return process.platform === "win32" ? "npm.cmd" : "npm";
+  return "npm";
+}
+
+function shouldUseWindowsShell(program: string): boolean {
+  if (process.platform !== "win32") {
+    return false;
+  }
+
+  const normalized = program.toLowerCase();
+  return normalized === "npm" || normalized.endsWith(".cmd") || normalized.endsWith(".bat");
 }
 
 export function initUsage(commandName = "openvcs"): string {
@@ -207,6 +216,7 @@ async function collectAnswers(
 function runNpmInstall(targetDir: string): void {
   const result = spawnSync(npmExecutable(), ["install"], {
     cwd: targetDir,
+    shell: shouldUseWindowsShell(npmExecutable()),
     stdio: "inherit",
   });
   if (result.error) {

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