@depup/angular__cli 21.2.1-depup.1

package/src/utilities/find-up.js

@@ -0,0 +1,67 @@
+"use strict";
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findUp = findUp;
+exports.findUpSync = findUpSync;
+const node_fs_1 = require("node:fs");
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+/**
+ * Find a file or directory by walking up the directory tree.
+ * @param names The name or names of the files or directories to find.
+ * @param from The directory to start the search from.
+ * @returns The path to the first match found, or `null` if no match was found.
+ */
+async function findUp(names, from) {
+    const filenames = Array.isArray(names) ? names : [names];
+    let currentDir = (0, node_path_1.resolve)(from);
+    while (true) {
+        for (const name of filenames) {
+            const p = (0, node_path_1.join)(currentDir, name);
+            try {
+                await (0, promises_1.stat)(p);
+                return p;
+            }
+            catch {
+                // Ignore errors (e.g. file not found).
+            }
+        }
+        const parentDir = (0, node_path_1.dirname)(currentDir);
+        if (parentDir === currentDir) {
+            break;
+        }
+        currentDir = parentDir;
+    }
+    return null;
+}
+/**
+ * Synchronously find a file or directory by walking up the directory tree.
+ * @param names The name or names of the files or directories to find.
+ * @param from The directory to start the search from.
+ * @returns The path to the first match found, or `null` if no match was found.
+ */
+function findUpSync(names, from) {
+    const filenames = Array.isArray(names) ? names : [names];
+    let currentDir = (0, node_path_1.resolve)(from);
+    while (true) {
+        for (const name of filenames) {
+            const p = (0, node_path_1.join)(currentDir, name);
+            if ((0, node_fs_1.existsSync)(p)) {
+                return p;
+            }
+        }
+        const parentDir = (0, node_path_1.dirname)(currentDir);
+        if (parentDir === currentDir) {
+            break;
+        }
+        currentDir = parentDir;
+    }
+    return null;
+}
+//# sourceMappingURL=find-up.js.map

package/src/utilities/find-up.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-up.js","sourceRoot":"","sources":["find-up.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAYH,wBAyBC;AAQD,gCAqBC;AAhED,qCAAqC;AACrC,+CAAwC;AACxC,yCAAmD;AAEnD;;;;;GAKG;AACI,KAAK,UAAU,MAAM,CAAC,KAAwB,EAAE,IAAY;IACjE,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAEzD,IAAI,UAAU,GAAG,IAAA,mBAAO,EAAC,IAAI,CAAC,CAAC;IAC/B,OAAO,IAAI,EAAE,CAAC;QACZ,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;YAC7B,MAAM,CAAC,GAAG,IAAA,gBAAI,EAAC,UAAU,EAAE,IAAI,CAAC,CAAC;YACjC,IAAI,CAAC;gBACH,MAAM,IAAA,eAAI,EAAC,CAAC,CAAC,CAAC;gBAEd,OAAO,CAAC,CAAC;YACX,CAAC;YAAC,MAAM,CAAC;gBACP,uCAAuC;YACzC,CAAC;QACH,CAAC;QAED,MAAM,SAAS,GAAG,IAAA,mBAAO,EAAC,UAAU,CAAC,CAAC;QACtC,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;YAC7B,MAAM;QACR,CAAC;QAED,UAAU,GAAG,SAAS,CAAC;IACzB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,SAAgB,UAAU,CAAC,KAAwB,EAAE,IAAY;IAC/D,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAEzD,IAAI,UAAU,GAAG,IAAA,mBAAO,EAAC,IAAI,CAAC,CAAC;IAC/B,OAAO,IAAI,EAAE,CAAC;QACZ,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;YAC7B,MAAM,CAAC,GAAG,IAAA,gBAAI,EAAC,UAAU,EAAE,IAAI,CAAC,CAAC;YACjC,IAAI,IAAA,oBAAU,EAAC,CAAC,CAAC,EAAE,CAAC;gBAClB,OAAO,CAAC,CAAC;YACX,CAAC;QACH,CAAC;QAED,MAAM,SAAS,GAAG,IAAA,mBAAO,EAAC,UAAU,CAAC,CAAC;QACtC,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;YAC7B,MAAM;QACR,CAAC;QAED,UAAU,GAAG,SAAS,CAAC;IACzB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/src/utilities/json-file.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+import { JsonValue } from '@angular-devkit/core';
+/** A function that returns an index to insert a new property in a JSON object. */
+export type InsertionIndex = (properties: string[]) => number;
+/** A JSON path. */
+export type JSONPath = (string | number)[];
+/**
+ * Reads and parses a JSON file, supporting comments and trailing commas.
+ * @param path The path to the JSON file.
+ * @returns The parsed JSON object.
+ */
+export declare function readAndParseJson<T extends JsonValue>(path: string): T;
+/**
+ * Parses a JSON string, supporting comments and trailing commas.
+ * @param content The JSON string to parse.
+ * @returns The parsed JSON object.
+ */
+export declare function parseJson<T extends JsonValue>(content: string): T;

package/src/utilities/json-file.js

@@ -0,0 +1,179 @@
+"use strict";
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JSONFile = void 0;
+exports.readAndParseJson = readAndParseJson;
+exports.parseJson = parseJson;
+const jsonc_parser_1 = require("jsonc-parser");
+const node_fs_1 = require("node:fs");
+const eol_1 = require("./eol");
+const error_1 = require("./error");
+/**
+ * Represents a JSON file, allowing for reading, modifying, and saving.
+ * This class uses `jsonc-parser` to preserve comments and formatting, including
+ * indentation and end-of-line sequences.
+ * @internal
+ */
+class JSONFile {
+    /** The raw content of the JSON file. */
+    #content;
+    /** The end-of-line sequence used in the file. */
+    #eol;
+    /** Whether the file uses spaces for indentation. */
+    #insertSpaces = true;
+    /** The number of spaces or tabs used for indentation. */
+    #tabSize = 2;
+    /** The path to the JSON file. */
+    #path;
+    /** The parsed JSON abstract syntax tree. */
+    #jsonAst;
+    /** The raw content of the JSON file. */
+    get content() {
+        return this.#content;
+    }
+    /**
+     * Creates an instance of JSONFile.
+     * @param path The path to the JSON file.
+     */
+    constructor(path) {
+        this.#path = path;
+        try {
+            this.#content = (0, node_fs_1.readFileSync)(this.#path, 'utf-8');
+        }
+        catch (e) {
+            (0, error_1.assertIsError)(e);
+            // We don't have to worry about ENOENT, since we'll be creating the file.
+            if (e.code !== 'ENOENT') {
+                throw e;
+            }
+            this.#content = '';
+        }
+        this.#eol = (0, eol_1.getEOL)(this.#content);
+        this.#detectIndentation();
+    }
+    /**
+     * Gets the parsed JSON abstract syntax tree.
+     * The AST is lazily parsed and cached.
+     */
+    get JsonAst() {
+        if (this.#jsonAst) {
+            return this.#jsonAst;
+        }
+        const errors = [];
+        this.#jsonAst = (0, jsonc_parser_1.parseTree)(this.#content, errors, { allowTrailingComma: true });
+        if (errors.length) {
+            formatError(this.#path, errors);
+        }
+        return this.#jsonAst;
+    }
+    /**
+     * Gets a value from the JSON file at a specific path.
+     * @param jsonPath The path to the value.
+     * @returns The value at the given path, or `undefined` if not found.
+     */
+    get(jsonPath) {
+        const jsonAstNode = this.JsonAst;
+        if (!jsonAstNode) {
+            return undefined;
+        }
+        if (jsonPath.length === 0) {
+            return (0, jsonc_parser_1.getNodeValue)(jsonAstNode);
+        }
+        const node = (0, jsonc_parser_1.findNodeAtLocation)(jsonAstNode, jsonPath);
+        return node === undefined ? undefined : (0, jsonc_parser_1.getNodeValue)(node);
+    }
+    /**
+     * Modifies a value in the JSON file.
+     * @param jsonPath The path to the value to modify.
+     * @param value The new value to insert.
+     * @param insertInOrder A function to determine the insertion index, or `false` to insert at the end.
+     * @returns `true` if the modification was successful, `false` otherwise.
+     */
+    modify(jsonPath, value, insertInOrder) {
+        if (value === undefined && this.get(jsonPath) === undefined) {
+            // Cannot remove a value which doesn't exist.
+            return false;
+        }
+        let getInsertionIndex;
+        if (insertInOrder === undefined) {
+            const property = jsonPath.slice(-1)[0];
+            getInsertionIndex = (properties) => [...properties, property].sort().findIndex((p) => p === property);
+        }
+        else if (insertInOrder !== false) {
+            getInsertionIndex = insertInOrder;
+        }
+        const edits = (0, jsonc_parser_1.modify)(this.#content, jsonPath, value, {
+            getInsertionIndex,
+            formattingOptions: {
+                insertSpaces: this.#insertSpaces,
+                tabSize: this.#tabSize,
+                eol: this.#eol,
+            },
+        });
+        if (edits.length === 0) {
+            return false;
+        }
+        this.#content = (0, jsonc_parser_1.applyEdits)(this.#content, edits);
+        this.#jsonAst = undefined;
+        return true;
+    }
+    /**
+     * Deletes a value from the JSON file at a specific path.
+     * @param jsonPath The path to the value to delete.
+     * @returns `true` if the deletion was successful, `false` otherwise.
+     */
+    delete(jsonPath) {
+        return this.modify(jsonPath, undefined);
+    }
+    /** Saves the modified content back to the file. */
+    save() {
+        (0, node_fs_1.writeFileSync)(this.#path, this.#content);
+    }
+    /** Detects the indentation of the file. */
+    #detectIndentation() {
+        // Find the first line that has indentation.
+        const match = this.#content.match(/^(?:( )+|\t+)\S/m);
+        if (match) {
+            this.#insertSpaces = !!match[1];
+            this.#tabSize = match[0].length - 1;
+        }
+    }
+}
+exports.JSONFile = JSONFile;
+/**
+ * Reads and parses a JSON file, supporting comments and trailing commas.
+ * @param path The path to the JSON file.
+ * @returns The parsed JSON object.
+ */
+function readAndParseJson(path) {
+    const errors = [];
+    const content = (0, jsonc_parser_1.parse)((0, node_fs_1.readFileSync)(path, 'utf-8'), errors, { allowTrailingComma: true });
+    if (errors.length) {
+        formatError(path, errors);
+    }
+    return content;
+}
+/**
+ * Formats a JSON parsing error and throws an exception.
+ * @param path The path to the file that failed to parse.
+ * @param errors The list of parsing errors.
+ */
+function formatError(path, errors) {
+    const { error, offset } = errors[0];
+    throw new Error(`Failed to parse "${path}" as JSON AST Object. ${(0, jsonc_parser_1.printParseErrorCode)(error)} at location: ${offset}.`);
+}
+/**
+ * Parses a JSON string, supporting comments and trailing commas.
+ * @param content The JSON string to parse.
+ * @returns The parsed JSON object.
+ */
+function parseJson(content) {
+    return (0, jsonc_parser_1.parse)(content, undefined, { allowTrailingComma: true });
+}
+//# sourceMappingURL=json-file.js.map

package/src/utilities/json-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-file.js","sourceRoot":"","sources":["json-file.ts"],"names":[],"mappings":"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"}

package/src/utilities/log-file.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+/**
+ * Writes an Error to a temporary log file.
+ * If this method is called multiple times from the same process the same log file will be used.
+ * @returns The path of the generated log file.
+ */
+export declare function writeErrorToLogFile(error: Error): string;

package/src/utilities/log-file.js

@@ -0,0 +1,28 @@
+"use strict";
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeErrorToLogFile = writeErrorToLogFile;
+const node_fs_1 = require("node:fs");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+let logPath;
+/**
+ * Writes an Error to a temporary log file.
+ * If this method is called multiple times from the same process the same log file will be used.
+ * @returns The path of the generated log file.
+ */
+function writeErrorToLogFile(error) {
+    if (!logPath) {
+        const tempDirectory = (0, node_fs_1.mkdtempSync)((0, node_fs_1.realpathSync)((0, node_os_1.tmpdir)()) + '/ng-');
+        logPath = (0, node_path_1.normalize)(tempDirectory + '/angular-errors.log');
+    }
+    (0, node_fs_1.appendFileSync)(logPath, '[error] ' + (error.stack || error) + '\n\n');
+    return logPath;
+}
+//# sourceMappingURL=log-file.js.map

package/src/utilities/log-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-file.js","sourceRoot":"","sources":["log-file.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAaH,kDASC;AApBD,qCAAoE;AACpE,qCAAiC;AACjC,yCAAsC;AAEtC,IAAI,OAA2B,CAAC;AAEhC;;;;GAIG;AACH,SAAgB,mBAAmB,CAAC,KAAY;IAC9C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,aAAa,GAAG,IAAA,qBAAW,EAAC,IAAA,sBAAY,EAAC,IAAA,gBAAM,GAAE,CAAC,GAAG,MAAM,CAAC,CAAC;QACnE,OAAO,GAAG,IAAA,qBAAS,EAAC,aAAa,GAAG,qBAAqB,CAAC,CAAC;IAC7D,CAAC;IAED,IAAA,wBAAc,EAAC,OAAO,EAAE,UAAU,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,GAAG,MAAM,CAAC,CAAC;IAEtE,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/src/utilities/memoize.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+/**
+ * A decorator that memoizes methods and getters.
+ *
+ * **Note**: Be cautious where and how to use this decorator as the size of the cache will grow unbounded.
+ *
+ * @see https://en.wikipedia.org/wiki/Memoization
+ */
+export declare function memoize<This, Args extends unknown[], Return>(target: (this: This, ...args: Args) => Return, context: ClassMemberDecoratorContext): (this: This, ...args: Args) => Return;

package/src/utilities/memoize.js

@@ -0,0 +1,64 @@
+"use strict";
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.memoize = memoize;
+/**
+ * A decorator that memoizes methods and getters.
+ *
+ * **Note**: Be cautious where and how to use this decorator as the size of the cache will grow unbounded.
+ *
+ * @see https://en.wikipedia.org/wiki/Memoization
+ */
+function memoize(target, context) {
+    if (context.kind !== 'method' && context.kind !== 'getter') {
+        throw new Error('Memoize decorator can only be used on methods or get accessors.');
+    }
+    const cache = new Map();
+    return function (...args) {
+        for (const arg of args) {
+            if (!isJSONSerializable(arg)) {
+                throw new Error(`Argument ${isNonPrimitive(arg) ? arg.toString() : arg} is JSON serializable.`);
+            }
+        }
+        const key = JSON.stringify(args);
+        if (cache.has(key)) {
+            return cache.get(key);
+        }
+        const result = target.apply(this, args);
+        cache.set(key, result);
+        return result;
+    };
+}
+/** Method to check if value is a non primitive. */
+function isNonPrimitive(value) {
+    return ((value !== null && typeof value === 'object') ||
+        typeof value === 'function' ||
+        typeof value === 'symbol');
+}
+/** Method to check if the values are JSON serializable */
+function isJSONSerializable(value) {
+    if (!isNonPrimitive(value)) {
+        // Can be seralized since it's a primitive.
+        return true;
+    }
+    let nestedValues;
+    if (Array.isArray(value)) {
+        // It's an array, check each item.
+        nestedValues = value;
+    }
+    else if (Object.prototype.toString.call(value) === '[object Object]') {
+        // It's a plain object, check each value.
+        nestedValues = Object.values(value);
+    }
+    if (!nestedValues || nestedValues.some((v) => !isJSONSerializable(v))) {
+        return false;
+    }
+    return true;
+}
+//# sourceMappingURL=memoize.js.map

package/src/utilities/memoize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memoize.js","sourceRoot":"","sources":["memoize.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AASH,0BA6BC;AApCD;;;;;;GAMG;AACH,SAAgB,OAAO,CACrB,MAA6C,EAC7C,OAAoC;IAEpC,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;IACrF,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IAExC,OAAO,UAAsB,GAAG,IAAU;QACxC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC7B,MAAM,IAAI,KAAK,CACb,YAAY,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,GAAG,wBAAwB,CAC/E,CAAC;YACJ,CAAC;QACH,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACnB,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,CAAW,CAAC;QAClC,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACxC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAEvB,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC;AAED,mDAAmD;AACnD,SAAS,cAAc,CAAC,KAAc;IACpC,OAAO,CACL,CAAC,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC;QAC7C,OAAO,KAAK,KAAK,UAAU;QAC3B,OAAO,KAAK,KAAK,QAAQ,CAC1B,CAAC;AACJ,CAAC;AAED,0DAA0D;AAC1D,SAAS,kBAAkB,CAAC,KAAc;IACxC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3B,2CAA2C;QAC3C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,YAAmC,CAAC;IACxC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,kCAAkC;QAClC,YAAY,GAAG,KAAK,CAAC;IACvB,CAAC;SAAM,IAAI,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,iBAAiB,EAAE,CAAC;QACvE,yCAAyC;QACzC,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;IAED,IAAI,CAAC,YAAY,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/src/utilities/package-metadata.d.ts

@@ -0,0 +1,58 @@
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+import { logging } from '@angular-devkit/core';
+import type { Manifest, Packument } from 'pacote';
+export interface PackageMetadata extends Packument, NgPackageManifestProperties {
+    tags: Record<string, PackageManifest>;
+    versions: Record<string, PackageManifest>;
+}
+export interface NpmRepositoryPackageJson extends PackageMetadata {
+    requestedName?: string;
+}
+export type NgAddSaveDependency = 'dependencies' | 'devDependencies' | boolean;
+export interface PackageIdentifier {
+    type: 'git' | 'tag' | 'version' | 'range' | 'file' | 'directory' | 'remote';
+    name: string;
+    scope: string | null;
+    registry: boolean;
+    raw: string;
+    fetchSpec: string;
+    rawSpec: string;
+}
+export interface NgPackageManifestProperties {
+    'ng-add'?: {
+        save?: NgAddSaveDependency;
+    };
+    'ng-update'?: {
+        migrations?: string;
+        packageGroup?: string[] | Record<string, string>;
+        packageGroupName?: string;
+        requirements?: string[] | Record<string, string>;
+    };
+}
+export interface PackageManifest extends Manifest, NgPackageManifestProperties {
+    deprecated?: boolean;
+    peerDependenciesMeta?: Record<string, {
+        optional?: boolean;
+    }>;
+}
+export declare function fetchPackageMetadata(name: string, logger: logging.LoggerApi, options?: {
+    registry?: string;
+    usingYarn?: boolean;
+    verbose?: boolean;
+}): Promise<PackageMetadata>;
+export declare function fetchPackageManifest(name: string, logger: logging.LoggerApi, options?: {
+    registry?: string;
+    usingYarn?: boolean;
+    verbose?: boolean;
+}): Promise<PackageManifest>;
+export declare function getNpmPackageJson(packageName: string, logger: logging.LoggerApi, options?: {
+    registry?: string;
+    usingYarn?: boolean;
+    verbose?: boolean;
+}): Promise<Partial<NpmRepositoryPackageJson>>;