@depup/nx 22.5.4-depup.0

package/src/command-line/generate/generator-utils.js

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getGeneratorInformation = getGeneratorInformation;
+exports.readGeneratorsJson = readGeneratorsJson;
+const path_1 = require("path");
+const schema_utils_1 = require("../../config/schema-utils");
+const fileutils_1 = require("../../utils/fileutils");
+const plugins_1 = require("../../project-graph/plugins");
+const installation_directory_1 = require("../../utils/installation-directory");
+function getGeneratorInformation(collectionName, generatorName, root, projects) {
+    try {
+        const { generatorsFilePath, generatorsJson, resolvedCollectionName, normalizedGeneratorName, } = readGeneratorsJson(collectionName, generatorName, root, projects);
+        const generatorsDir = (0, path_1.dirname)(generatorsFilePath);
+        const generatorConfig = generatorsJson.generators?.[normalizedGeneratorName] ||
+            generatorsJson.schematics?.[normalizedGeneratorName];
+        const isNgCompat = !generatorsJson.generators?.[normalizedGeneratorName];
+        const schemaPath = (0, schema_utils_1.resolveSchema)(generatorConfig.schema, generatorsDir, collectionName, projects);
+        const schema = (0, fileutils_1.readJsonFile)(schemaPath);
+        if (!schema.properties || typeof schema.properties !== 'object') {
+            schema.properties = {};
+        }
+        generatorConfig.implementation =
+            generatorConfig.implementation || generatorConfig.factory;
+        const implementationFactory = (0, schema_utils_1.getImplementationFactory)(generatorConfig.implementation, generatorsDir, collectionName, projects);
+        const normalizedGeneratorConfiguration = {
+            ...generatorConfig,
+            aliases: generatorConfig.aliases ?? [],
+            hidden: !!generatorConfig.hidden,
+        };
+        return {
+            resolvedCollectionName,
+            normalizedGeneratorName,
+            schema,
+            implementationFactory,
+            isNgCompat,
+            isNxGenerator: !isNgCompat,
+            generatorConfiguration: normalizedGeneratorConfiguration,
+        };
+    }
+    catch (e) {
+        throw new Error(`Unable to resolve ${collectionName}:${generatorName}.\n${process.env.NX_VERBOSE_LOGGING === 'true' ? e.stack : e.message}`);
+    }
+}
+function readGeneratorsJson(collectionName, generator, root, projects) {
+    let generatorsFilePath;
+    if (collectionName.endsWith('.json')) {
+        generatorsFilePath = require.resolve(collectionName, {
+            paths: root
+                ? [...(0, installation_directory_1.getNxRequirePaths)(root), __dirname]
+                : [...(0, installation_directory_1.getNxRequirePaths)(), __dirname],
+        });
+    }
+    else {
+        const { json: packageJson, path: packageJsonPath } = (0, plugins_1.readPluginPackageJson)(collectionName, projects, root
+            ? [...(0, installation_directory_1.getNxRequirePaths)(root), __dirname]
+            : [...(0, installation_directory_1.getNxRequirePaths)(), __dirname]);
+        const generatorsFile = packageJson.generators ?? packageJson.schematics;
+        if (!generatorsFile) {
+            throw new Error(`The "${collectionName}" package does not support Nx generators.`);
+        }
+        generatorsFilePath = require.resolve((0, path_1.join)((0, path_1.dirname)(packageJsonPath), generatorsFile));
+    }
+    const generatorsJson = (0, fileutils_1.readJsonFile)(generatorsFilePath);
+    let normalizedGeneratorName = findFullGeneratorName(generator, generatorsJson.generators) ||
+        findFullGeneratorName(generator, generatorsJson.schematics);
+    if (!normalizedGeneratorName) {
+        for (let parent of generatorsJson.extends || []) {
+            try {
+                return readGeneratorsJson(parent, generator, root, projects);
+            }
+            catch (e) { }
+        }
+        throw new Error(`Cannot find generator '${generator}' in ${generatorsFilePath}.`);
+    }
+    return {
+        generatorsFilePath,
+        generatorsJson,
+        normalizedGeneratorName,
+        resolvedCollectionName: collectionName,
+    };
+}
+function findFullGeneratorName(name, generators) {
+    if (generators) {
+        for (let [key, data] of Object.entries(generators)) {
+            if (key === name ||
+                (data.aliases && data.aliases.includes(name))) {
+                return key;
+            }
+        }
+    }
+}

package/src/command-line/graph/command-object.d.ts

@@ -0,0 +1,26 @@
+import { Argv, CommandModule } from 'yargs';
+export declare const yargsGraphCommand: CommandModule;
+export declare function withGraphOptions(yargs: Argv): Argv<{
+    file: string;
+} & {
+    print: boolean;
+} & {
+    view: string;
+} & {
+    targets: string;
+} & {
+    focus: string;
+} & {
+    exclude: string;
+} & {
+    groupByFolder: boolean;
+} & {
+    host: string;
+} & {
+    port: number;
+} & {
+    watch: boolean;
+} & {
+    open: boolean;
+}>;
+//# sourceMappingURL=command-object.d.ts.map

package/src/command-line/graph/command-object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-object.d.ts","sourceRoot":"","sources":["../../../../../../packages/nx/src/command-line/graph/command-object.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAQ5C,eAAO,MAAM,iBAAiB,EAAE,aAoB/B,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,IAAI;;;;;;;;;;;;;;;;;;;;;;GAiE3C"}

package/src/command-line/graph/command-object.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.yargsGraphCommand = void 0;
+exports.withGraphOptions = withGraphOptions;
+const documentation_1 = require("../yargs-utils/documentation");
+const shared_options_1 = require("../yargs-utils/shared-options");
+exports.yargsGraphCommand = {
+    command: 'graph',
+    describe: 'Graph dependencies within workspace.',
+    aliases: ['dep-graph'],
+    builder: (yargs) => (0, documentation_1.linkToNxDevAndExamples)((0, shared_options_1.withVerbose)((0, shared_options_1.withAffectedOptions)(withGraphOptions(yargs))), 'dep-graph')
+        .option('affected', {
+        type: 'boolean',
+        description: 'Highlight affected projects.',
+    })
+        .implies('untracked', 'affected')
+        .implies('uncommitted', 'affected')
+        .implies('files', 'affected')
+        .implies('base', 'affected')
+        .implies('head', 'affected'),
+    handler: async (args) => await (await Promise.resolve().then(() => require('./graph'))).generateGraph(args, []),
+};
+function withGraphOptions(yargs) {
+    return yargs
+        .option('file', {
+        describe: 'Output file (e.g. --file=output.json or --file=dep-graph.html).',
+        type: 'string',
+    })
+        .option('print', {
+        describe: 'Print the project graph to stdout in the terminal.',
+        type: 'boolean',
+    })
+        .option('view', {
+        describe: 'Choose whether to view the projects or task graph.',
+        type: 'string',
+        default: 'projects',
+        choices: ['projects', 'tasks'],
+    })
+        .option('targets', {
+        describe: 'The target to show tasks for in the task graph.',
+        type: 'string',
+        coerce: shared_options_1.parseCSV,
+    })
+        .option('focus', {
+        describe: 'Use to show the project graph for a particular project and every node that is either an ancestor or a descendant.',
+        type: 'string',
+    })
+        .option('exclude', {
+        describe: 'List of projects delimited by commas to exclude from the project graph.',
+        type: 'string',
+        coerce: shared_options_1.parseCSV,
+    })
+        .option('groupByFolder', {
+        describe: 'Group projects by folder in the project graph.',
+        type: 'boolean',
+    })
+        .option('host', {
+        describe: 'Bind the project graph server to a specific ip address.',
+        type: 'string',
+    })
+        .option('port', {
+        describe: 'Bind the project graph server to a specific port.',
+        type: 'number',
+    })
+        .option('watch', {
+        describe: 'Watch for changes to project graph and update in-browser.',
+        type: 'boolean',
+        default: true,
+    })
+        .option('open', {
+        describe: 'Open the project graph in the browser.',
+        type: 'boolean',
+        default: true,
+    });
+}

package/src/command-line/graph/graph.d.ts

@@ -0,0 +1,70 @@
+import { ProjectFileMap, ProjectGraph, ProjectGraphDependency, ProjectGraphProjectNode } from '../../config/project-graph';
+import { TaskGraph } from '../../config/task-graph';
+export interface GraphError {
+    message: string;
+    stack: string;
+    cause: unknown;
+    name: string;
+    pluginName: string;
+    fileName?: string;
+}
+export interface ProjectGraphClientResponse {
+    hash: string;
+    projects: ProjectGraphProjectNode[];
+    dependencies: Record<string, ProjectGraphDependency[]>;
+    fileMap?: ProjectFileMap;
+    layout: {
+        appsDir: string;
+        libsDir: string;
+    };
+    affected: string[];
+    focus: string;
+    groupByFolder: boolean;
+    exclude: string[];
+    isPartial: boolean;
+    errors?: GraphError[];
+    connectedToCloud?: boolean;
+    disabledTaskSyncGenerators?: string[];
+}
+export interface TaskGraphClientResponse {
+    taskGraph: TaskGraph;
+    plans?: Record<string, string[]>;
+    error?: string | null;
+}
+export interface ExpandedTaskInputsReponse {
+    [taskId: string]: Record<string, string[]>;
+}
+export declare function generateGraph(args: {
+    file?: string;
+    print?: boolean;
+    host?: string;
+    port?: number;
+    groupByFolder?: boolean;
+    watch?: boolean;
+    open?: boolean;
+    view: 'projects' | 'tasks' | 'project-details';
+    projects?: string[];
+    all?: boolean;
+    targets?: string[];
+    focus?: string;
+    exclude?: string[];
+    affected?: boolean;
+}, affectedProjects: string[]): Promise<void>;
+/**
+ * The data type that `nx graph --file graph.json` or `nx build --graph graph.json` contains
+ */
+export interface GraphJson {
+    /**
+     * A graph of tasks populated with `nx build --graph`
+     */
+    tasks?: TaskGraph;
+    /**
+     * The plans for hashing a task in the task graph
+     */
+    taskPlans?: Record<string, string[]>;
+    /**
+     * The project graph
+     */
+    graph: ProjectGraph;
+}
+//# sourceMappingURL=graph.d.ts.map

package/src/command-line/graph/graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../../../../../packages/nx/src/command-line/graph/graph.ts"],"names":[],"mappings":"AA2BA,OAAO,EAEL,cAAc,EACd,YAAY,EACZ,sBAAsB,EACtB,uBAAuB,EACxB,MAAM,4BAA4B,CAAC;AAKpC,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAwBpD,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,uBAAuB,EAAE,CAAC;IACpC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,EAAE,CAAC,CAAC;IACvD,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,OAAO,CAAC;IACvB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC;IACtB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,0BAA0B,CAAC,EAAE,MAAM,EAAE,CAAC;CACvC;AAED,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,SAAS,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,yBAAyB;IACxC,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAC5C;AAkJD,wBAAsB,aAAa,CACjC,IAAI,EAAE;IACJ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,UAAU,GAAG,OAAO,GAAG,iBAAiB,CAAC;IAC/C,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,EACD,gBAAgB,EAAE,MAAM,EAAE,GACzB,OAAO,CAAC,IAAI,CAAC,CA2Tf;AAw0BD;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB;;OAEG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACrC;;OAEG;IACH,KAAK,EAAE,YAAY,CAAC;CACrB"}