@microtronics/studio-cli 1.1.0-alpha.0 → 1.1.0-alpha.2

package/dist/studio-cli.d.ts

@@ -1945,9 +1945,38 @@ export declare namespace Dependencies {
      * @param libraryName
      */
     export function uninstallDependency(cwd: URI, fs: LocalFS, logger: Log.Logger, publisherId: string, libraryName: string): Promise<void>;
+    /**
+     * Read the npm workspace patterns declared in the root package.json, if any.
+     * Supports both the array form (`workspaces: [...]`) and the object form (`workspaces: { packages: [...] }`).
+     * Never throws - returns null if the file is missing, invalid JSON, or has no usable workspaces field.
+     * @param cwd
+     * @param fs
+     */
+    export function readNpmWorkspacePatterns(cwd: URI, fs: LocalFS): Promise<string[] | null>;
+    /**
+     * Check if the given working path is covered by any of the given npm workspace patterns.
+     * @param workingPath
+     * @param patterns
+     */
+    export function isPathInWorkspaces(workingPath: string, patterns: string[]): boolean;
+    /**
+     * Plan which parts need a dedicated `npm install`/`npm ci` and whether a single install at the project root
+     * covers the rest via npm workspaces.
+     * @param parts
+     * @param patterns - npm workspace patterns from the root package.json, or null if not a workspace root
+     */
+    export function planNpmInstalls(parts: {
+        name: string;
+        workingPath: string;
+    }[], patterns: string[] | null): {
+        rootInstall: boolean;
+        partInstalls: string[];
+    };
     /**
      * Install npm dependencies in pov and blo working paths if they exist and contain a package.json.
      * This ensures that a single `studio install` command sets up the entire project.
+     * If the root package.json declares npm workspaces that cover a part, the install is done once at the
+     * project root instead of separately for each covered part.
      * @param cwd
      * @param fs
      * @param logger
@@ -2441,8 +2470,12 @@ export declare enum HttpMethod {
 
 /**
  * Installs the specified dependencies or all dependencies if none are provided.
- * Additionally runs `npm install` in pov and blo working paths if they exist and contain a package.json,
- * ensuring a single install command sets up the entire project.
+ * Additionally runs npm install in pov and blo working paths if they exist and contain a package.json,
+ * ensuring a single install command sets up the entire project. When the root package.json declares npm
+ * workspaces that cover a part, the npm dependencies are installed once at the project root instead of
+ * separately for each covered part; parts not covered by any workspace pattern are still installed
+ * individually. `npm install` is used instead of `npm ci` when no package-lock.json exists, or as a
+ * fallback when the lockfile is out of sync with package.json.
  *
  * @param {URI} cwd - The current working directory where the installation process takes place.
  * @param {LocalFS} fs - The file system interface used for managing files during the installation process.