@depup/angular-devkit__core 21.2.2-depup.0

package/src/virtual-fs/path.js

@@ -0,0 +1,286 @@
+"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.path = exports.NormalizedRoot = exports.NormalizedSep = exports.PathCannotBeFragmentException = exports.PathMustBeAbsoluteException = exports.InvalidPathException = void 0;
+exports.split = split;
+exports.extname = extname;
+exports.basename = basename;
+exports.dirname = dirname;
+exports.join = join;
+exports.isAbsolute = isAbsolute;
+exports.relative = relative;
+exports.resolve = resolve;
+exports.fragment = fragment;
+exports.resetNormalizeCache = resetNormalizeCache;
+exports.normalize = normalize;
+exports.noCacheNormalize = noCacheNormalize;
+exports.asWindowsPath = asWindowsPath;
+exports.asPosixPath = asPosixPath;
+exports.getSystemPath = getSystemPath;
+const exception_1 = require("../exception");
+class InvalidPathException extends exception_1.BaseException {
+    constructor(path) {
+        super(`Path ${JSON.stringify(path)} is invalid.`);
+    }
+}
+exports.InvalidPathException = InvalidPathException;
+class PathMustBeAbsoluteException extends exception_1.BaseException {
+    constructor(path) {
+        super(`Path ${JSON.stringify(path)} must be absolute.`);
+    }
+}
+exports.PathMustBeAbsoluteException = PathMustBeAbsoluteException;
+class PathCannotBeFragmentException extends exception_1.BaseException {
+    constructor(path) {
+        super(`Path ${JSON.stringify(path)} cannot be made a fragment.`);
+    }
+}
+exports.PathCannotBeFragmentException = PathCannotBeFragmentException;
+/**
+ * The Separator for normalized path.
+ */
+exports.NormalizedSep = '/';
+/**
+ * The root of a normalized path.
+ */
+exports.NormalizedRoot = exports.NormalizedSep;
+/**
+ * Split a path into multiple path fragments. Each fragments except the last one will end with
+ * a path separator.
+ * @param {Path} path The path to split.
+ * @returns {Path[]} An array of path fragments.
+ */
+function split(path) {
+    const fragments = path.split(exports.NormalizedSep).map((x) => fragment(x));
+    if (fragments.at(-1)?.length === 0) {
+        fragments.pop();
+    }
+    return fragments;
+}
+/**
+ *
+ */
+function extname(path) {
+    const base = basename(path);
+    const i = base.lastIndexOf('.');
+    if (i < 1) {
+        return '';
+    }
+    else {
+        return base.slice(i);
+    }
+}
+/**
+ * Return the basename of the path, as a Path. See path.basename
+ */
+function basename(path) {
+    const i = path.lastIndexOf(exports.NormalizedSep);
+    if (i == -1) {
+        return fragment(path);
+    }
+    else {
+        return fragment(path.slice(path.lastIndexOf(exports.NormalizedSep) + 1));
+    }
+}
+/**
+ * Return the dirname of the path, as a Path. See path.dirname
+ */
+function dirname(path) {
+    const index = path.lastIndexOf(exports.NormalizedSep);
+    if (index === -1) {
+        return '';
+    }
+    const endIndex = index === 0 ? 1 : index; // case of file under root: '/file'
+    return normalize(path.slice(0, endIndex));
+}
+/**
+ * Join multiple paths together, and normalize the result. Accepts strings that will be
+ * normalized as well (but the original must be a path).
+ */
+function join(p1, ...others) {
+    if (others.length > 0) {
+        return normalize((p1 ? p1 + exports.NormalizedSep : '') + others.join(exports.NormalizedSep));
+    }
+    else {
+        return p1;
+    }
+}
+/**
+ * Returns true if a path is absolute.
+ */
+function isAbsolute(p) {
+    return p.startsWith(exports.NormalizedSep);
+}
+/**
+ * Returns a path such that `join(from, relative(from, to)) == to`.
+ * Both paths must be absolute, otherwise it does not make much sense.
+ */
+function relative(from, to) {
+    if (!isAbsolute(from)) {
+        throw new PathMustBeAbsoluteException(from);
+    }
+    if (!isAbsolute(to)) {
+        throw new PathMustBeAbsoluteException(to);
+    }
+    let p;
+    if (from == to) {
+        p = '';
+    }
+    else {
+        const splitFrom = split(from);
+        const splitTo = split(to);
+        while (splitFrom.length > 0 && splitTo.length > 0 && splitFrom[0] == splitTo[0]) {
+            splitFrom.shift();
+            splitTo.shift();
+        }
+        if (splitFrom.length == 0) {
+            p = splitTo.join(exports.NormalizedSep);
+        }
+        else {
+            p = splitFrom
+                .map(() => '..')
+                .concat(splitTo)
+                .join(exports.NormalizedSep);
+        }
+    }
+    return normalize(p);
+}
+/**
+ * Returns a Path that is the resolution of p2, from p1. If p2 is absolute, it will return p2,
+ * otherwise will join both p1 and p2.
+ */
+function resolve(p1, p2) {
+    if (isAbsolute(p2)) {
+        return p2;
+    }
+    else {
+        return join(p1, p2);
+    }
+}
+function fragment(path) {
+    if (path.indexOf(exports.NormalizedSep) != -1) {
+        throw new PathCannotBeFragmentException(path);
+    }
+    return path;
+}
+/**
+ * normalize() cache to reduce computation. For now this grows and we never flush it, but in the
+ * future we might want to add a few cache flush to prevent this from growing too large.
+ */
+let normalizedCache = new Map();
+/**
+ * Reset the cache. This is only useful for testing.
+ * @private
+ */
+function resetNormalizeCache() {
+    normalizedCache = new Map();
+}
+/**
+ * Normalize a string into a Path. This is the only mean to get a Path type from a string that
+ * represents a system path. This method cache the results as real world paths tend to be
+ * duplicated often.
+ * Normalization includes:
+ *   - Windows backslashes `\\` are replaced with `/`.
+ *   - Windows drivers are replaced with `/X/`, where X is the drive letter.
+ *   - Absolute paths starts with `/`.
+ *   - Multiple `/` are replaced by a single one.
+ *   - Path segments `.` are removed.
+ *   - Path segments `..` are resolved.
+ *   - If a path is absolute, having a `..` at the start is invalid (and will throw).
+ * @param path The path to be normalized.
+ */
+function normalize(path) {
+    let maybePath = normalizedCache.get(path);
+    if (!maybePath) {
+        maybePath = noCacheNormalize(path);
+        normalizedCache.set(path, maybePath);
+    }
+    return maybePath;
+}
+/**
+ * The no cache version of the normalize() function. Used for benchmarking and testing.
+ */
+function noCacheNormalize(path) {
+    if (path == '' || path == '.') {
+        return '';
+    }
+    else if (path == exports.NormalizedRoot) {
+        return exports.NormalizedRoot;
+    }
+    // Match absolute windows path.
+    const original = path;
+    if (path.match(/^[A-Z]:[/\\]/i)) {
+        path = '\\' + path[0].toUpperCase() + '\\' + path.slice(3);
+    }
+    // We convert Windows paths as well here.
+    const p = path.split(/[/\\]/g);
+    let relative = false;
+    let i = 1;
+    // Special case the first one.
+    if (p[0] != '') {
+        p.unshift('.');
+        relative = true;
+    }
+    while (i < p.length) {
+        if (p[i] == '.') {
+            p.splice(i, 1);
+        }
+        else if (p[i] == '..') {
+            if (i < 2 && !relative) {
+                throw new InvalidPathException(original);
+            }
+            else if (i >= 2 && p[i - 1] != '..') {
+                p.splice(i - 1, 2);
+                i--;
+            }
+            else {
+                i++;
+            }
+        }
+        else if (p[i] == '') {
+            p.splice(i, 1);
+        }
+        else {
+            i++;
+        }
+    }
+    if (p.length == 1) {
+        return p[0] == '' ? exports.NormalizedSep : '';
+    }
+    else {
+        if (p[0] == '.') {
+            p.shift();
+        }
+        return p.join(exports.NormalizedSep);
+    }
+}
+const path = (strings, ...values) => {
+    return normalize(String.raw(strings, ...values));
+};
+exports.path = path;
+function asWindowsPath(path) {
+    const drive = path.match(/^\/(\w)(?:\/(.*))?$/);
+    if (drive) {
+        const subPath = drive[2] ? drive[2].replace(/\//g, '\\') : '';
+        return `${drive[1]}:\\${subPath}`;
+    }
+    return path.replace(/\//g, '\\');
+}
+function asPosixPath(path) {
+    return path;
+}
+function getSystemPath(path) {
+    if (process.platform.startsWith('win32')) {
+        return asWindowsPath(path);
+    }
+    else {
+        return asPosixPath(path);
+    }
+}
+//# sourceMappingURL=path.js.map

package/src/virtual-fs/path.js.map

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

package/src/workspace/core.d.ts

@@ -0,0 +1,61 @@
+/**
+ * @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 { WorkspaceDefinition } from './definitions';
+import { WorkspaceHost } from './host';
+/**
+ * Supported workspace formats
+ */
+export declare enum WorkspaceFormat {
+    JSON = 0
+}
+/**
+ * @private
+ */
+export declare function _test_addWorkspaceFile(name: string, format: WorkspaceFormat): void;
+/**
+ * @private
+ */
+export declare function _test_removeWorkspaceFile(name: string): void;
+/**
+ * Reads and constructs a `WorkspaceDefinition`.  If the function is provided with a path to a
+ * directory instead of a file, a search of the directory's files will commence to attempt to
+ * locate a known workspace file.  Currently the following are considered known workspace files:
+ * - `angular.json`
+ * - `.angular.json`
+ *
+ * @param path The path to either a workspace file or a directory containing a workspace file.
+ * @param host The `WorkspaceHost` to use to access the file and directory data.
+ * @param format An optional `WorkspaceFormat` value. Used if the path specifies a non-standard
+ * file name that would prevent automatically discovering the format.
+ *
+ *
+ * @return An `Promise` of the read result object with the `WorkspaceDefinition` contained within
+ * the `workspace` property.
+ */
+export declare function readWorkspace(path: string, host: WorkspaceHost, format?: WorkspaceFormat): Promise<{
+    workspace: WorkspaceDefinition;
+}>;
+/**
+ * Writes a `WorkspaceDefinition` to the underlying storage via the provided `WorkspaceHost`.
+ * If the `WorkspaceDefinition` was created via the `readWorkspace` function, metadata will be
+ * used to determine the path and format of the Workspace.  In all other cases, the `path` and
+ * `format` options must be specified as they would be otherwise unknown.
+ *
+ * @param workspace The `WorkspaceDefinition` that will be written.
+ * @param host The `WorkspaceHost` to use to access/write the file and directory data.
+ * @param path The path to a file location for the output. Required if `readWorkspace` was not
+ * used to create the `WorkspaceDefinition`.  Optional otherwise; will override the
+ * `WorkspaceDefinition` metadata if provided.
+ * @param format The `WorkspaceFormat` to use for output. Required if `readWorkspace` was not
+ * used to create the `WorkspaceDefinition`.  Optional otherwise; will override the
+ * `WorkspaceDefinition` metadata if provided.
+ *
+ *
+ * @return An `Promise` of type `void`.
+ */
+export declare function writeWorkspace(workspace: WorkspaceDefinition, host: WorkspaceHost, path?: string, format?: WorkspaceFormat): Promise<void>;

package/src/workspace/core.js

@@ -0,0 +1,133 @@
+"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.WorkspaceFormat = void 0;
+exports._test_addWorkspaceFile = _test_addWorkspaceFile;
+exports._test_removeWorkspaceFile = _test_removeWorkspaceFile;
+exports.readWorkspace = readWorkspace;
+exports.writeWorkspace = writeWorkspace;
+const virtual_fs_1 = require("../virtual-fs");
+const reader_1 = require("./json/reader");
+const writer_1 = require("./json/writer");
+const formatLookup = new WeakMap();
+/**
+ * Supported workspace formats
+ */
+var WorkspaceFormat;
+(function (WorkspaceFormat) {
+    WorkspaceFormat[WorkspaceFormat["JSON"] = 0] = "JSON";
+})(WorkspaceFormat || (exports.WorkspaceFormat = WorkspaceFormat = {}));
+/**
+ * @private
+ */
+function _test_addWorkspaceFile(name, format) {
+    workspaceFiles[name] = format;
+}
+/**
+ * @private
+ */
+function _test_removeWorkspaceFile(name) {
+    delete workspaceFiles[name];
+}
+// NOTE: future additions could also perform content analysis to determine format/version
+const workspaceFiles = {
+    'angular.json': WorkspaceFormat.JSON,
+    '.angular.json': WorkspaceFormat.JSON,
+};
+/**
+ * Reads and constructs a `WorkspaceDefinition`.  If the function is provided with a path to a
+ * directory instead of a file, a search of the directory's files will commence to attempt to
+ * locate a known workspace file.  Currently the following are considered known workspace files:
+ * - `angular.json`
+ * - `.angular.json`
+ *
+ * @param path The path to either a workspace file or a directory containing a workspace file.
+ * @param host The `WorkspaceHost` to use to access the file and directory data.
+ * @param format An optional `WorkspaceFormat` value. Used if the path specifies a non-standard
+ * file name that would prevent automatically discovering the format.
+ *
+ *
+ * @return An `Promise` of the read result object with the `WorkspaceDefinition` contained within
+ * the `workspace` property.
+ */
+async function readWorkspace(path, host, format) {
+    if (await host.isDirectory(path)) {
+        // TODO: Warn if multiple found (requires diagnostics support)
+        const directory = (0, virtual_fs_1.normalize)(path);
+        let found = false;
+        for (const [name, nameFormat] of Object.entries(workspaceFiles)) {
+            if (format !== undefined && format !== nameFormat) {
+                continue;
+            }
+            const potential = (0, virtual_fs_1.getSystemPath)((0, virtual_fs_1.join)(directory, name));
+            if (await host.isFile(potential)) {
+                path = potential;
+                format = nameFormat;
+                found = true;
+                break;
+            }
+        }
+        if (!found) {
+            throw new Error('Unable to locate a workspace file for workspace path. Are you missing an `angular.json`' +
+                ' or `.angular.json` file?');
+        }
+    }
+    else if (format === undefined) {
+        const filename = (0, virtual_fs_1.basename)((0, virtual_fs_1.normalize)(path));
+        if (filename in workspaceFiles) {
+            format = workspaceFiles[filename];
+        }
+    }
+    if (format === undefined) {
+        throw new Error('Unable to determine format for workspace path.');
+    }
+    let workspace;
+    switch (format) {
+        case WorkspaceFormat.JSON:
+            workspace = await (0, reader_1.readJsonWorkspace)(path, host);
+            break;
+        default:
+            throw new Error('Unsupported workspace format.');
+    }
+    formatLookup.set(workspace, WorkspaceFormat.JSON);
+    return { workspace };
+}
+/**
+ * Writes a `WorkspaceDefinition` to the underlying storage via the provided `WorkspaceHost`.
+ * If the `WorkspaceDefinition` was created via the `readWorkspace` function, metadata will be
+ * used to determine the path and format of the Workspace.  In all other cases, the `path` and
+ * `format` options must be specified as they would be otherwise unknown.
+ *
+ * @param workspace The `WorkspaceDefinition` that will be written.
+ * @param host The `WorkspaceHost` to use to access/write the file and directory data.
+ * @param path The path to a file location for the output. Required if `readWorkspace` was not
+ * used to create the `WorkspaceDefinition`.  Optional otherwise; will override the
+ * `WorkspaceDefinition` metadata if provided.
+ * @param format The `WorkspaceFormat` to use for output. Required if `readWorkspace` was not
+ * used to create the `WorkspaceDefinition`.  Optional otherwise; will override the
+ * `WorkspaceDefinition` metadata if provided.
+ *
+ *
+ * @return An `Promise` of type `void`.
+ */
+async function writeWorkspace(workspace, host, path, format) {
+    if (format === undefined) {
+        format = formatLookup.get(workspace);
+        if (format === undefined) {
+            throw new Error('A format is required for custom workspace objects.');
+        }
+    }
+    switch (format) {
+        case WorkspaceFormat.JSON:
+            return (0, writer_1.writeJsonWorkspace)(workspace, host, path);
+        default:
+            throw new Error('Unsupported workspace format.');
+    }
+}
+//# sourceMappingURL=core.js.map

package/src/workspace/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","sourceRoot":"","sources":["core.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAoBH,wDAEC;AAKD,8DAEC;AAwBD,sCAoDC;AAoBD,wCAmBC;AA9ID,8CAAyE;AAGzE,0CAAkD;AAClD,0CAAmD;AAEnD,MAAM,YAAY,GAAG,IAAI,OAAO,EAAwC,CAAC;AAEzE;;GAEG;AACH,IAAY,eAEX;AAFD,WAAY,eAAe;IACzB,qDAAI,CAAA;AACN,CAAC,EAFW,eAAe,+BAAf,eAAe,QAE1B;AAED;;GAEG;AACH,SAAgB,sBAAsB,CAAC,IAAY,EAAE,MAAuB;IAC1E,cAAc,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,SAAgB,yBAAyB,CAAC,IAAY;IACpD,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED,yFAAyF;AACzF,MAAM,cAAc,GAAoC;IACtD,cAAc,EAAE,eAAe,CAAC,IAAI;IACpC,eAAe,EAAE,eAAe,CAAC,IAAI;CACtC,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACI,KAAK,UAAU,aAAa,CACjC,IAAY,EACZ,IAAmB,EACnB,MAAwB;IAGxB,IAAI,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;QACjC,8DAA8D;QAC9D,MAAM,SAAS,GAAG,IAAA,sBAAS,EAAC,IAAI,CAAC,CAAC;QAClC,IAAI,KAAK,GAAG,KAAK,CAAC;QAClB,KAAK,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC;YAChE,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,UAAU,EAAE,CAAC;gBAClD,SAAS;YACX,CAAC;YAED,MAAM,SAAS,GAAG,IAAA,0BAAa,EAAC,IAAA,iBAAI,EAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC;YACvD,IAAI,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;gBACjC,IAAI,GAAG,SAAS,CAAC;gBACjB,MAAM,GAAG,UAAU,CAAC;gBACpB,KAAK,GAAG,IAAI,CAAC;gBACb,MAAM;YACR,CAAC;QACH,CAAC;QACD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CACb,yFAAyF;gBACvF,2BAA2B,CAC9B,CAAC;QACJ,CAAC;IACH,CAAC;SAAM,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QAChC,MAAM,QAAQ,GAAG,IAAA,qBAAQ,EAAC,IAAA,sBAAS,EAAC,IAAI,CAAC,CAAC,CAAC;QAC3C,IAAI,QAAQ,IAAI,cAAc,EAAE,CAAC;YAC/B,MAAM,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAED,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;IAED,IAAI,SAAS,CAAC;IACd,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,eAAe,CAAC,IAAI;YACvB,SAAS,GAAG,MAAM,IAAA,0BAAiB,EAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAChD,MAAM;QACR;YACE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACrD,CAAC;IAED,YAAY,CAAC,GAAG,CAAC,SAAS,EAAE,eAAe,CAAC,IAAI,CAAC,CAAC;IAElD,OAAO,EAAE,SAAS,EAAE,CAAC;AACvB,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACI,KAAK,UAAU,cAAc,CAClC,SAA8B,EAC9B,IAAmB,EACnB,IAAa,EACb,MAAwB;IAExB,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACrC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;IAED,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,eAAe,CAAC,IAAI;YACvB,OAAO,IAAA,2BAAkB,EAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QACnD;YACE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACrD,CAAC;AACH,CAAC"}

package/src/workspace/definitions.d.ts

@@ -0,0 +1,63 @@
+/**
+ * @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 '../json';
+export interface WorkspaceDefinition {
+    readonly extensions: Record<string, JsonValue | undefined>;
+    readonly projects: ProjectDefinitionCollection;
+}
+export interface ProjectDefinition {
+    readonly extensions: Record<string, JsonValue | undefined>;
+    readonly targets: TargetDefinitionCollection;
+    root: string;
+    prefix?: string;
+    sourceRoot?: string;
+}
+export interface TargetDefinition {
+    options?: Record<string, JsonValue | undefined>;
+    configurations?: Record<string, Record<string, JsonValue | undefined> | undefined>;
+    defaultConfiguration?: string;
+    builder: string;
+}
+export type DefinitionCollectionListener<V extends object> = (name: string, newValue: V | undefined, collection: DefinitionCollection<V>) => void;
+declare class DefinitionCollection<V extends object> implements ReadonlyMap<string, V> {
+    private _listener?;
+    private _map;
+    constructor(initial?: Record<string, V>, _listener?: DefinitionCollectionListener<V> | undefined);
+    delete(key: string): boolean;
+    set(key: string, value: V): this;
+    forEach<T>(callbackfn: (value: V, key: string, map: DefinitionCollection<V>) => void, thisArg?: T): void;
+    get(key: string): V | undefined;
+    has(key: string): boolean;
+    get size(): number;
+    [Symbol.iterator](): MapIterator<[string, V]>;
+    entries(): MapIterator<[string, V]>;
+    keys(): MapIterator<string>;
+    values(): MapIterator<V>;
+}
+export declare class ProjectDefinitionCollection extends DefinitionCollection<ProjectDefinition> {
+    constructor(initial?: Record<string, ProjectDefinition>, listener?: DefinitionCollectionListener<ProjectDefinition>);
+    add(definition: {
+        name: string;
+        root: string;
+        sourceRoot?: string;
+        prefix?: string;
+        targets?: Record<string, TargetDefinition | undefined>;
+        [key: string]: unknown;
+    }): ProjectDefinition;
+    set(name: string, value: ProjectDefinition): this;
+    private _validateName;
+}
+export declare class TargetDefinitionCollection extends DefinitionCollection<TargetDefinition> {
+    constructor(initial?: Record<string, TargetDefinition>, listener?: DefinitionCollectionListener<TargetDefinition>);
+    add(definition: {
+        name: string;
+    } & TargetDefinition): TargetDefinition;
+    set(name: string, value: TargetDefinition): this;
+    private _validateName;
+}
+export {};