@vscode/python-environments 1.3.0 → 1.4.0

package/CHANGELOG.md

@@ -5,6 +5,12 @@ All notable changes to the `@vscode/python-environments` API package are documen
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.4.0]
+
+### Changed
+
+- Reorganized the package source into separate API facade, public contract, and public error modules without changing the root package exports.
+
 ## [1.3.0]
 
 ### Added

package/README.md

@@ -35,3 +35,20 @@ export async function activate() {
 }
 ```
 
+## Full API reference
+
+📘 **[Python Environments API reference](https://github.com/microsoft/vscode-python-environments/blob/main/docs/README.md)**
+
+The complete manual documents every method and data type, organized by domain -
+environments, packages, projects, execution, environment variables, and
+extensibility - with field tables, parameter tables, return types, and examples.
+
+- [Environments](https://github.com/microsoft/vscode-python-environments/blob/main/docs/README.md#environments) - discover, resolve, select, create, and remove interpreters
+- [Packages](https://github.com/microsoft/vscode-python-environments/blob/main/docs/README.md#packages) - list, install, uninstall, and look up versions
+- [Projects](https://github.com/microsoft/vscode-python-environments/blob/main/docs/README.md#projects) - the folders the extension tracks
+- [Execution](https://github.com/microsoft/vscode-python-environments/blob/main/docs/README.md#execution) - run Python in terminals, tasks, and background processes
+- [Environment variables](https://github.com/microsoft/vscode-python-environments/blob/main/docs/README.md#environment-variables) - resolved variables for a scope
+- [Extensibility](https://github.com/microsoft/vscode-python-environments/blob/main/docs/README.md#extensibility) - register your own environment manager, package manager, or project creator
+
+See [`CHANGELOG.md`](https://github.com/microsoft/vscode-python-environments/blob/main/api/CHANGELOG.md) for API changes between versions.
+

package/out/cjs/main.cjs

@@ -1,82 +1,33 @@
 "use strict";
 // Copyright (c) Microsoft Corporation. All rights reserved.
 // Licensed under the MIT License.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PythonEnvironments = exports.EXTENSION_ID = exports.PackageVersionLookupNotSupportedError = exports.PackageChangeKind = exports.EnvironmentChangeKind = void 0;
-exports.isPackageVersionLookupNotSupportedError = isPackageVersionLookupNotSupportedError;
+exports.PythonEnvironments = exports.EXTENSION_ID = void 0;
 const vscode_1 = require("vscode");
-/**
- * Enum representing the kinds of environment changes.
- */
-var EnvironmentChangeKind;
-(function (EnvironmentChangeKind) {
-    /**
-     * Indicates that an environment was added.
-     */
-    EnvironmentChangeKind["add"] = "add";
-    /**
-     * Indicates that an environment was removed.
-     */
-    EnvironmentChangeKind["remove"] = "remove";
-})(EnvironmentChangeKind || (exports.EnvironmentChangeKind = EnvironmentChangeKind = {}));
-/**
- * Enum representing the kinds of package changes.
- */
-var PackageChangeKind;
-(function (PackageChangeKind) {
-    /**
-     * Indicates that a package was added.
-     */
-    PackageChangeKind["add"] = "add";
-    /**
-     * Indicates that a package was removed.
-     */
-    PackageChangeKind["remove"] = "remove";
-})(PackageChangeKind || (exports.PackageChangeKind = PackageChangeKind = {}));
-/**
- * Error thrown when a package manager cannot list available package versions.
- *
- * This distinguishes an *unsupported capability* from an *operational failure* (such as a
- * failed command, a network error, or malformed/unparseable output). Consumers of
- * {@link PythonPackageGetterApi.getPackageAvailableVersions} should treat this specific error
- * as a signal to fall back to manual version entry, while letting any other error propagate.
- *
- * The {@link code} property carries a stable, string-literal discriminator so the error can be
- * recognized reliably across extension bundle boundaries, where `instanceof` may fail because
- * each bundle can load its own copy of this class. Prefer {@link isPackageVersionLookupNotSupportedError}
- * over a bare `instanceof` check for that reason.
- */
-class PackageVersionLookupNotSupportedError extends Error {
-    constructor(message) {
-        super(message ?? 'The package manager does not support looking up available package versions.');
-        /**
-         * Stable discriminator identifying this error type across bundle boundaries.
-         */
-        this.code = 'PackageVersionLookupNotSupported';
-        this.name = 'PackageVersionLookupNotSupportedError';
-        // Preserve the prototype chain when this class is transpiled to older targets so that
-        // `instanceof` continues to work within a single bundle.
-        Object.setPrototypeOf(this, PackageVersionLookupNotSupportedError.prototype);
-    }
-}
-exports.PackageVersionLookupNotSupportedError = PackageVersionLookupNotSupportedError;
-/**
- * Type guard reporting whether an error represents unsupported package version lookup.
- *
- * Uses the stable {@link PackageVersionLookupNotSupportedError.code} discriminator, so it returns
- * `true` even when the error crossed an extension bundle boundary and `instanceof` would fail.
+/*
+ * Do not introduce any breaking changes to this API.
+ * This is the public API for other extensions to interact with the Python Environments extension.
  *
- * @param error The value to test.
- * @returns `true` if `error` is a {@link PackageVersionLookupNotSupportedError} (or a structurally
- *          equivalent error carrying the same `code`).
+ * This module is a small public runtime/package facade: it re-exports all public type contracts
+ * from `./types` and the concrete error/guard from `./publicErrors`, and hosts the runtime surface
+ * (`EXTENSION_ID` and `PythonEnvironments.api()`).
  */
-function isPackageVersionLookupNotSupportedError(error) {
-    return (error instanceof PackageVersionLookupNotSupportedError ||
-        (typeof error === 'object' &&
-            error !== null &&
-            'code' in error &&
-            error.code === 'PackageVersionLookupNotSupported'));
-}
+__exportStar(require("./types.js"), exports);
+__exportStar(require("./publicErrors.js"), exports);
 exports.EXTENSION_ID = 'ms-python.vscode-python-envs';
 var PythonEnvironments;
 (function (PythonEnvironments) {

package/out/cjs/publicErrors.js

@@ -0,0 +1,55 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PackageVersionLookupNotSupportedError = void 0;
+exports.isPackageVersionLookupNotSupportedError = isPackageVersionLookupNotSupportedError;
+/*
+ * Concrete, public runtime error type(s) for the Python Environments API.
+ * Kept separate from `./types.ts` (pure contracts) and re-exported from `./api.ts` to keep
+ * that facade small.
+ */
+/**
+ * Error thrown when a package manager cannot list available package versions.
+ *
+ * This distinguishes an *unsupported capability* from an *operational failure* (such as a
+ * failed command, a network error, or malformed/unparseable output). Consumers of
+ * {@link PythonPackageGetterApi.getPackageAvailableVersions} should treat this specific error
+ * as a signal to fall back to manual version entry, while letting any other error propagate.
+ *
+ * The {@link code} property carries a stable, string-literal discriminator so the error can be
+ * recognized reliably across extension bundle boundaries, where `instanceof` may fail because
+ * each bundle can load its own copy of this class. Prefer {@link isPackageVersionLookupNotSupportedError}
+ * over a bare `instanceof` check for that reason.
+ */
+class PackageVersionLookupNotSupportedError extends Error {
+    constructor(message) {
+        super(message ?? 'The package manager does not support looking up available package versions.');
+        /**
+         * Stable discriminator identifying this error type across bundle boundaries.
+         */
+        this.code = 'PackageVersionLookupNotSupported';
+        this.name = 'PackageVersionLookupNotSupportedError';
+        // Preserve the prototype chain when this class is transpiled to older targets so that
+        // `instanceof` continues to work within a single bundle.
+        Object.setPrototypeOf(this, PackageVersionLookupNotSupportedError.prototype);
+    }
+}
+exports.PackageVersionLookupNotSupportedError = PackageVersionLookupNotSupportedError;
+/**
+ * Type guard reporting whether an error represents unsupported package version lookup.
+ *
+ * Uses the stable {@link PackageVersionLookupNotSupportedError.code} discriminator, so it returns
+ * `true` even when the error crossed an extension bundle boundary and `instanceof` would fail.
+ *
+ * @param error The value to test.
+ * @returns `true` if `error` is a {@link PackageVersionLookupNotSupportedError} (or a structurally
+ *          equivalent error carrying the same `code`).
+ */
+function isPackageVersionLookupNotSupportedError(error) {
+    return (error instanceof PackageVersionLookupNotSupportedError ||
+        (typeof error === 'object' &&
+            error !== null &&
+            'code' in error &&
+            error.code === 'PackageVersionLookupNotSupported'));
+}

package/out/cjs/types.js

@@ -0,0 +1,33 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PackageChangeKind = exports.EnvironmentChangeKind = void 0;
+/**
+ * Enum representing the kinds of environment changes.
+ */
+var EnvironmentChangeKind;
+(function (EnvironmentChangeKind) {
+    /**
+     * Indicates that an environment was added.
+     */
+    EnvironmentChangeKind["add"] = "add";
+    /**
+     * Indicates that an environment was removed.
+     */
+    EnvironmentChangeKind["remove"] = "remove";
+})(EnvironmentChangeKind || (exports.EnvironmentChangeKind = EnvironmentChangeKind = {}));
+/**
+ * Enum representing the kinds of package changes.
+ */
+var PackageChangeKind;
+(function (PackageChangeKind) {
+    /**
+     * Indicates that a package was added.
+     */
+    PackageChangeKind["add"] = "add";
+    /**
+     * Indicates that a package was removed.
+     */
+    PackageChangeKind["remove"] = "remove";
+})(PackageChangeKind || (exports.PackageChangeKind = PackageChangeKind = {}));

package/out/esm/main.mjs

@@ -1,77 +1,16 @@
 // Copyright (c) Microsoft Corporation. All rights reserved.
 // Licensed under the MIT License.
 import { extensions } from 'vscode';
-/**
- * Enum representing the kinds of environment changes.
- */
-export var EnvironmentChangeKind;
-(function (EnvironmentChangeKind) {
-    /**
-     * Indicates that an environment was added.
-     */
-    EnvironmentChangeKind["add"] = "add";
-    /**
-     * Indicates that an environment was removed.
-     */
-    EnvironmentChangeKind["remove"] = "remove";
-})(EnvironmentChangeKind || (EnvironmentChangeKind = {}));
-/**
- * Enum representing the kinds of package changes.
- */
-export var PackageChangeKind;
-(function (PackageChangeKind) {
-    /**
-     * Indicates that a package was added.
-     */
-    PackageChangeKind["add"] = "add";
-    /**
-     * Indicates that a package was removed.
-     */
-    PackageChangeKind["remove"] = "remove";
-})(PackageChangeKind || (PackageChangeKind = {}));
-/**
- * Error thrown when a package manager cannot list available package versions.
- *
- * This distinguishes an *unsupported capability* from an *operational failure* (such as a
- * failed command, a network error, or malformed/unparseable output). Consumers of
- * {@link PythonPackageGetterApi.getPackageAvailableVersions} should treat this specific error
- * as a signal to fall back to manual version entry, while letting any other error propagate.
- *
- * The {@link code} property carries a stable, string-literal discriminator so the error can be
- * recognized reliably across extension bundle boundaries, where `instanceof` may fail because
- * each bundle can load its own copy of this class. Prefer {@link isPackageVersionLookupNotSupportedError}
- * over a bare `instanceof` check for that reason.
- */
-export class PackageVersionLookupNotSupportedError extends Error {
-    constructor(message) {
-        super(message ?? 'The package manager does not support looking up available package versions.');
-        /**
-         * Stable discriminator identifying this error type across bundle boundaries.
-         */
-        this.code = 'PackageVersionLookupNotSupported';
-        this.name = 'PackageVersionLookupNotSupportedError';
-        // Preserve the prototype chain when this class is transpiled to older targets so that
-        // `instanceof` continues to work within a single bundle.
-        Object.setPrototypeOf(this, PackageVersionLookupNotSupportedError.prototype);
-    }
-}
-/**
- * Type guard reporting whether an error represents unsupported package version lookup.
- *
- * Uses the stable {@link PackageVersionLookupNotSupportedError.code} discriminator, so it returns
- * `true` even when the error crossed an extension bundle boundary and `instanceof` would fail.
+/*
+ * Do not introduce any breaking changes to this API.
+ * This is the public API for other extensions to interact with the Python Environments extension.
  *
- * @param error The value to test.
- * @returns `true` if `error` is a {@link PackageVersionLookupNotSupportedError} (or a structurally
- *          equivalent error carrying the same `code`).
+ * This module is a small public runtime/package facade: it re-exports all public type contracts
+ * from `./types` and the concrete error/guard from `./publicErrors`, and hosts the runtime surface
+ * (`EXTENSION_ID` and `PythonEnvironments.api()`).
  */
-export function isPackageVersionLookupNotSupportedError(error) {
-    return (error instanceof PackageVersionLookupNotSupportedError ||
-        (typeof error === 'object' &&
-            error !== null &&
-            'code' in error &&
-            error.code === 'PackageVersionLookupNotSupported'));
-}
+export * from './types.js';
+export * from './publicErrors.js';
 export const EXTENSION_ID = 'ms-python.vscode-python-envs';
 export var PythonEnvironments;
 (function (PythonEnvironments) {

package/out/esm/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/out/esm/publicErrors.js

@@ -0,0 +1,50 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+/*
+ * Concrete, public runtime error type(s) for the Python Environments API.
+ * Kept separate from `./types.ts` (pure contracts) and re-exported from `./api.ts` to keep
+ * that facade small.
+ */
+/**
+ * Error thrown when a package manager cannot list available package versions.
+ *
+ * This distinguishes an *unsupported capability* from an *operational failure* (such as a
+ * failed command, a network error, or malformed/unparseable output). Consumers of
+ * {@link PythonPackageGetterApi.getPackageAvailableVersions} should treat this specific error
+ * as a signal to fall back to manual version entry, while letting any other error propagate.
+ *
+ * The {@link code} property carries a stable, string-literal discriminator so the error can be
+ * recognized reliably across extension bundle boundaries, where `instanceof` may fail because
+ * each bundle can load its own copy of this class. Prefer {@link isPackageVersionLookupNotSupportedError}
+ * over a bare `instanceof` check for that reason.
+ */
+export class PackageVersionLookupNotSupportedError extends Error {
+    constructor(message) {
+        super(message ?? 'The package manager does not support looking up available package versions.');
+        /**
+         * Stable discriminator identifying this error type across bundle boundaries.
+         */
+        this.code = 'PackageVersionLookupNotSupported';
+        this.name = 'PackageVersionLookupNotSupportedError';
+        // Preserve the prototype chain when this class is transpiled to older targets so that
+        // `instanceof` continues to work within a single bundle.
+        Object.setPrototypeOf(this, PackageVersionLookupNotSupportedError.prototype);
+    }
+}
+/**
+ * Type guard reporting whether an error represents unsupported package version lookup.
+ *
+ * Uses the stable {@link PackageVersionLookupNotSupportedError.code} discriminator, so it returns
+ * `true` even when the error crossed an extension bundle boundary and `instanceof` would fail.
+ *
+ * @param error The value to test.
+ * @returns `true` if `error` is a {@link PackageVersionLookupNotSupportedError} (or a structurally
+ *          equivalent error carrying the same `code`).
+ */
+export function isPackageVersionLookupNotSupportedError(error) {
+    return (error instanceof PackageVersionLookupNotSupportedError ||
+        (typeof error === 'object' &&
+            error !== null &&
+            'code' in error &&
+            error.code === 'PackageVersionLookupNotSupported'));
+}

package/out/esm/types.js

@@ -0,0 +1,30 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+/**
+ * Enum representing the kinds of environment changes.
+ */
+export var EnvironmentChangeKind;
+(function (EnvironmentChangeKind) {
+    /**
+     * Indicates that an environment was added.
+     */
+    EnvironmentChangeKind["add"] = "add";
+    /**
+     * Indicates that an environment was removed.
+     */
+    EnvironmentChangeKind["remove"] = "remove";
+})(EnvironmentChangeKind || (EnvironmentChangeKind = {}));
+/**
+ * Enum representing the kinds of package changes.
+ */
+export var PackageChangeKind;
+(function (PackageChangeKind) {
+    /**
+     * Indicates that a package was added.
+     */
+    PackageChangeKind["add"] = "add";
+    /**
+     * Indicates that a package was removed.
+     */
+    PackageChangeKind["remove"] = "remove";
+})(PackageChangeKind || (PackageChangeKind = {}));

package/out/types/main.d.ts

@@ -0,0 +1,10 @@
+import type { PythonEnvironmentApi } from './types.js';
+export * from './types.js';
+export * from './publicErrors.js';
+export declare const EXTENSION_ID = "ms-python.vscode-python-envs";
+export declare namespace PythonEnvironments {
+    /**
+     * Returns the API exposed by the Python Environments extension in VS Code.
+     */
+    function api(): Promise<PythonEnvironmentApi>;
+}

package/out/types/publicErrors.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Error thrown when a package manager cannot list available package versions.
+ *
+ * This distinguishes an *unsupported capability* from an *operational failure* (such as a
+ * failed command, a network error, or malformed/unparseable output). Consumers of
+ * {@link PythonPackageGetterApi.getPackageAvailableVersions} should treat this specific error
+ * as a signal to fall back to manual version entry, while letting any other error propagate.
+ *
+ * The {@link code} property carries a stable, string-literal discriminator so the error can be
+ * recognized reliably across extension bundle boundaries, where `instanceof` may fail because
+ * each bundle can load its own copy of this class. Prefer {@link isPackageVersionLookupNotSupportedError}
+ * over a bare `instanceof` check for that reason.
+ */
+export declare class PackageVersionLookupNotSupportedError extends Error {
+    /**
+     * Stable discriminator identifying this error type across bundle boundaries.
+     */
+    readonly code = "PackageVersionLookupNotSupported";
+    constructor(message?: string);
+}
+/**
+ * Type guard reporting whether an error represents unsupported package version lookup.
+ *
+ * Uses the stable {@link PackageVersionLookupNotSupportedError.code} discriminator, so it returns
+ * `true` even when the error crossed an extension bundle boundary and `instanceof` would fail.
+ *
+ * @param error The value to test.
+ * @returns `true` if `error` is a {@link PackageVersionLookupNotSupportedError} (or a structurally
+ *          equivalent error carrying the same `code`).
+ */
+export declare function isPackageVersionLookupNotSupportedError(error: unknown): error is PackageVersionLookupNotSupportedError;

package/out/{cjs/main.d.ts → types/types.d.ts}

@@ -414,24 +414,21 @@ export interface EnvironmentManager {
      */
     onDidChangeEnvironment?: Event<DidChangeEnvironmentEventArgs>;
     /**
-     * Resolves the specified Python environment. The environment can be either a {@link PythonEnvironment} or a {@link Uri} context.
+     * Resolves the Python environment associated with the specified URI context.
      *
-     * This method is used to obtain a fully detailed {@link PythonEnvironment} object. The input can be:
-     * - A {@link PythonEnvironment} object, which might be missing key details such as {@link PythonEnvironment.execInfo}.
-     * - A {@link Uri} object, which typically represents either:
-     *   - A folder that contains the Python environment.
-     *   - The path to a Python executable.
+     * This method is used to obtain a fully detailed {@link PythonEnvironment} object. The input
+     * URI typically represents either a folder that contains the Python environment or the path to
+     * a Python executable.
      *
-     * @param context - The context for resolving the environment, which can be a {@link PythonEnvironment} or a {@link Uri}.
+     * @param context - The URI context for resolving the environment.
      * @returns A promise that resolves to the fully detailed {@link PythonEnvironment}, or `undefined` if the environment cannot be resolved.
      *
      * @remarks
-     * Called to turn a lightly-populated {@link PythonEnvironment} or a {@link Uri}
-     * pointing at an interpreter or environment folder into a fully-populated
-     * {@link PythonEnvironment} with complete {@link PythonEnvironment.execInfo}. Typical
-     * triggers include the user manually selecting an interpreter path, resolving
-     * `python.defaultInterpreterPath` at startup, and populating execution details before
-     * launching Python.
+     * Called to turn a {@link Uri} pointing at an interpreter or environment folder into a
+     * fully-populated {@link PythonEnvironment} with complete {@link PythonEnvironment.execInfo}.
+     * Typical triggers include the user manually selecting an interpreter path, resolving
+     * `python.defaultInterpreterPath` at startup, and populating execution details before launching
+     * Python.
      */
     resolve(context: ResolveEnvironmentContext): Promise<PythonEnvironment | undefined>;
     /**
@@ -915,10 +912,10 @@ export interface PythonEnvironmentsApi {
      */
     onDidChangeEnvironments: Event<DidChangeEnvironmentsEventArgs>;
     /**
-     * This method is used to get the details missing from a PythonEnvironment. Like
-     * {@link PythonEnvironment.execInfo} and other details.
+     * This method is used to get the details for the Python environment associated with a URI
+     * context, such as an interpreter path or environment folder.
      *
-     * @param context : The PythonEnvironment or Uri for which details are required.
+     * @param context - The URI context for which environment details are required.
      */
     resolveEnvironment(context: ResolveEnvironmentContext): Promise<PythonEnvironment | undefined>;
 }
@@ -958,37 +955,6 @@ export interface PythonPackageManagerRegistrationApi {
         extensionId?: string;
     }): Disposable;
 }
-/**
- * Error thrown when a package manager cannot list available package versions.
- *
- * This distinguishes an *unsupported capability* from an *operational failure* (such as a
- * failed command, a network error, or malformed/unparseable output). Consumers of
- * {@link PythonPackageGetterApi.getPackageAvailableVersions} should treat this specific error
- * as a signal to fall back to manual version entry, while letting any other error propagate.
- *
- * The {@link code} property carries a stable, string-literal discriminator so the error can be
- * recognized reliably across extension bundle boundaries, where `instanceof` may fail because
- * each bundle can load its own copy of this class. Prefer {@link isPackageVersionLookupNotSupportedError}
- * over a bare `instanceof` check for that reason.
- */
-export declare class PackageVersionLookupNotSupportedError extends Error {
-    /**
-     * Stable discriminator identifying this error type across bundle boundaries.
-     */
-    readonly code = "PackageVersionLookupNotSupported";
-    constructor(message?: string);
-}
-/**
- * Type guard reporting whether an error represents unsupported package version lookup.
- *
- * Uses the stable {@link PackageVersionLookupNotSupportedError.code} discriminator, so it returns
- * `true` even when the error crossed an extension bundle boundary and `instanceof` would fail.
- *
- * @param error The value to test.
- * @returns `true` if `error` is a {@link PackageVersionLookupNotSupportedError} (or a structurally
- *          equivalent error carrying the same `code`).
- */
-export declare function isPackageVersionLookupNotSupportedError(error: unknown): error is PackageVersionLookupNotSupportedError;
 /**
  * Controls how package version lookup failures are reported.
  */
@@ -1243,7 +1209,9 @@ export interface PythonBackgroundRunOptions {
      */
     args: string[];
     /**
-     * Current working directory for the script or module. Default is the project directory for the script being run.
+     * Current working directory for the script or module. This is passed directly to the spawned
+     * process; when it is omitted the process inherits the extension host's working directory,
+     * which is not the project directory. Supply this when the script resolves relative paths.
      */
     cwd?: string;
     /**
@@ -1307,10 +1275,3 @@ export interface PythonEnvironmentVariablesApi {
  */
 export interface PythonEnvironmentApi extends PythonEnvironmentManagerApi, PythonPackageManagerApi, PythonProjectApi, PythonExecutionApi, PythonEnvironmentVariablesApi {
 }
-export declare const EXTENSION_ID = "ms-python.vscode-python-envs";
-export declare namespace PythonEnvironments {
-    /**
-     * Returns the API exposed by the Python Environments extension in VS Code.
-     */
-    function api(): Promise<PythonEnvironmentApi>;
-}

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@vscode/python-environments",
     "description": "An API facade for the Python Environments extension in VS Code",
-    "version": "1.3.0",
+    "version": "1.4.0",
     "author": {
         "name": "Microsoft Corporation"
     },
@@ -12,14 +12,14 @@
         "Environments"
     ],
     "main": "./out/cjs/main.cjs",
-    "types": "./out/cjs/main.d.ts",
+    "types": "./out/types/main.d.ts",
     "exports": {
         "import": {
-            "types": "./out/esm/main.d.ts",
+            "types": "./out/types/main.d.ts",
             "default": "./out/esm/main.mjs"
         },
         "require": {
-            "types": "./out/cjs/main.d.ts",
+            "types": "./out/types/main.d.ts",
             "default": "./out/cjs/main.cjs"
         }
     },
@@ -39,11 +39,14 @@
     "scripts": {
         "prepublishOnly": "echo \"⛔ Can only publish from a secure pipeline ⛔\" && node -e \"process.exitCode = 1\"",
         "prepack": "npm run all:publish",
-        "all:publish": "git clean -xfd . && npm install && npm run compile",
-        "compile": "npm run compile:esm && npm run compile:cjs",
-        "compile:esm": "tsc -b ./tsconfig.esm.json && mve out/esm/main.js out/esm/main.mjs",
+        "all:publish": "git clean -xfd . && npm install && npm run copy:sources && npm run compile",
+        "copy:sources": "node ./scripts/copy-sources.cjs",
+        "compile": "npm run clean && npm run compile:types && npm run compile:esm && npm run compile:cjs",
+        "compile:types": "tsc -b ./tsconfig.types.json",
+        "compile:esm": "tsc -b ./tsconfig.esm.json && mve out/esm/main.js out/esm/main.mjs && node -e \"require('fs').writeFileSync('out/esm/package.json', '{\\\"type\\\":\\\"module\\\"}')\"",
         "compile:cjs": "tsc -b ./tsconfig.cjs.json && mve out/cjs/main.js out/cjs/main.cjs",
         "clean": "node -e \"const fs = require('fs'); fs.rmSync('./out', { recursive: true, force: true });\"",
+        "test": "npm run test:package",
         "test:package": "node ./scripts/test-package.cjs"
     },
     "devDependencies": {