@microtronics/studio-cli 1.1.0-alpha.1 → 1.1.0-alpha.3

package/dist/studio-cli.d.ts

@@ -1945,9 +1945,51 @@ 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[];
+    };
+    /**
+     * Normalize the `dist/blo` and `dist/pov/details` `package.json` files of every already-installed library
+     * reachable from the consumer's `libraryDependencies`/`libraryDevDependencies` (version stamping and
+     * stripping of npm-invalid Studio-library dependency entries), walking each library's own
+     * `libraryDependencies`/`libraryDevDependencies` transitively.
+     * This fixes already-published libraries whose dist part files were never touched by a build with this fix.
+     * A library not yet installed under `.studio/libdeps` is skipped silently. Errors normalizing an individual
+     * library are logged and skipped - this must never break an install.
+     * @param cwd
+     * @param fs
+     * @param logger
+     */
+    export function normalizeInstalledLibraryParts(cwd: URI, fs: LocalFS, logger: Log.Logger): Promise<void>;
     /**
      * 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 +2483,14 @@ 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. Before that, every already-installed library's
+ * `dist/blo`/`dist/pov/details` `package.json` is normalized to the library's `studio.json` version and stripped
+ * of any npm dependency entries that reference other Studio libraries.
  *
  * @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.
@@ -2664,6 +2712,15 @@ export declare namespace Manifest {
      * @param fs
      */
     export function readAsBlob(cwd: URI, fs: LocalFS): Promise<Uint8Array>;
+    /**
+     * Read the studio.json manifest of an installed library, uncached and without the CLI's global `overwrites`
+     * applied. Use this (instead of `read`) for reading manifests of installed libraries under `.studio/libdeps/`:
+     * `read` returns a manifest deep-merged with CLI-flag overwrites (e.g. `--version`) meant for the current
+     * project, which must never leak onto a library's own manifest.
+     * @param cwd
+     * @param fs
+     */
+    export function readRaw(cwd: URI, fs: LocalFS): Promise<Manifest>;
     /**
      * Write the manifest to the workspace
      * @param cwd