@redocly/cli 2.19.2 → 2.20.0

package/lib/commands/join/helpers/iterate-potential-conflicts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iterate-potential-conflicts.d.ts","sourceRoot":"","sources":["../../../../src/commands/join/helpers/iterate-potential-conflicts.ts"],"names":[],"mappings":"AA0BA,wBAAgB,yBAAyB,CAAC,EACxC,kBAAkB,EAClB,iBAAiB,GAClB,EAAE;IACD,kBAAkB,EAAE,GAAG,CAAC;IACxB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B,UA8BA"}

package/lib/commands/join/helpers/iterate-potential-conflicts.js

@@ -0,0 +1,53 @@
+import { dequal } from '@redocly/openapi-core';
+import { green } from 'colorette';
+import { COMPONENTS } from '../../split/types.js';
+import { duplicateTagDescriptionWarning } from './duplicate-tag-description-warning.js';
+import { filterConflicts } from './filter-conflicts.js';
+import { prefixTagSuggestion } from './prefix-tag-suggestion.js';
+import { showConflicts } from './show-conflicts.js';
+function doesComponentsDiffer(curr, next) {
+    return !dequal(Object.values(curr)[0], Object.values(next)[0]);
+}
+function validateComponentsDifference(files) {
+    let isDiffer = false;
+    for (let i = 0, len = files.length; i < len; i++) {
+        const next = files[i + 1];
+        if (next && doesComponentsDiffer(files[i], next)) {
+            isDiffer = true;
+        }
+    }
+    return isDiffer;
+}
+let potentialConflictsTotal = 0;
+export function iteratePotentialConflicts({ potentialConflicts, withoutXTagGroups, }) {
+    for (const group of Object.keys(potentialConflicts)) {
+        for (const [key, value] of Object.entries(potentialConflicts[group])) {
+            const conflicts = filterConflicts(value);
+            if (conflicts.length) {
+                if (group === COMPONENTS) {
+                    for (const [_, conflict] of Object.entries(conflicts)) {
+                        if (validateComponentsDifference(conflict[1])) {
+                            conflict[1] = conflict[1].map((c) => Object.keys(c)[0]);
+                            showConflicts(green(group) + ' => ' + key, [conflict]);
+                            potentialConflictsTotal += 1;
+                        }
+                    }
+                }
+                else {
+                    if (withoutXTagGroups && group === 'tags') {
+                        duplicateTagDescriptionWarning(conflicts);
+                    }
+                    else {
+                        potentialConflictsTotal += conflicts.length;
+                        showConflicts(green(group) + ' => ' + key, conflicts);
+                    }
+                }
+                if (group === 'tags' && !withoutXTagGroups) {
+                    prefixTagSuggestion(conflicts.length);
+                }
+            }
+        }
+    }
+    return potentialConflictsTotal;
+}
+//# sourceMappingURL=iterate-potential-conflicts.js.map

package/lib/commands/join/helpers/iterate-potential-conflicts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"iterate-potential-conflicts.js","sourceRoot":"","sources":["../../../../src/commands/join/helpers/iterate-potential-conflicts.ts"],"names":[],"mappings":"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"}

package/lib/commands/join/helpers/populate-tags.d.ts

@@ -0,0 +1,7 @@
+import type { JoinDocumentContext } from '../types.js';
+export declare function populateTags({ joinedDef, withoutXTagGroups, context, }: {
+    joinedDef: any;
+    withoutXTagGroups: boolean | undefined;
+    context: JoinDocumentContext;
+}): void;
+//# sourceMappingURL=populate-tags.d.ts.map

package/lib/commands/join/helpers/populate-tags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"populate-tags.d.ts","sourceRoot":"","sources":["../../../../src/commands/join/helpers/populate-tags.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAOvD,wBAAgB,YAAY,CAAC,EAC3B,SAAS,EACT,iBAAiB,EACjB,OAAO,GACR,EAAE;IACD,SAAS,EAAE,GAAG,CAAC;IACf,iBAAiB,EAAE,OAAO,GAAG,SAAS,CAAC;IACvC,OAAO,EAAE,mBAAmB,CAAC;CAC9B,QAsEA"}

package/lib/commands/join/helpers/populate-tags.js

@@ -0,0 +1,77 @@
+import { addComponentsPrefix } from './add-components-prefix.js';
+import { addPrefix } from './add-prefix.js';
+const Tags = 'tags';
+const xTagGroups = 'x-tagGroups';
+export function populateTags({ joinedDef, withoutXTagGroups, context, }) {
+    const { api, apiFilename, apiTitle, tags, potentialConflicts, tagsPrefix, componentsPrefix, oasVersion, } = context;
+    if (!joinedDef.hasOwnProperty(Tags)) {
+        joinedDef[Tags] = [];
+    }
+    if (!potentialConflicts.tags.hasOwnProperty('all')) {
+        potentialConflicts.tags['all'] = {};
+    }
+    if (withoutXTagGroups && !potentialConflicts.tags.hasOwnProperty('description')) {
+        potentialConflicts.tags['description'] = {};
+    }
+    for (const tag of tags || []) {
+        const entrypointTagName = addPrefix(tag.name, tagsPrefix);
+        if (tag.description) {
+            tag.description = addComponentsPrefix(tag.description, componentsPrefix);
+        }
+        const tagDuplicate = joinedDef.tags.find((t) => t.name === entrypointTagName);
+        if (tagDuplicate && withoutXTagGroups) {
+            // If tag already exist and `without-x-tag-groups` option,
+            // check if description are different for potential conflicts warning.
+            const isTagDescriptionNotEqual = tag.hasOwnProperty('description') && tagDuplicate.description !== tag.description;
+            potentialConflicts.tags.description[entrypointTagName].push(...(isTagDescriptionNotEqual ? [api] : []));
+        }
+        else if (!tagDuplicate) {
+            if (oasVersion === 'oas3_0' || oasVersion === 'oas3_1') {
+                tag['x-displayName'] = tag['x-displayName'] || tag.name;
+            }
+            else if (oasVersion === 'oas3_2') {
+                tag.summary = tag.summary || tag.name;
+            }
+            tag.name = entrypointTagName;
+            joinedDef.tags.push(tag);
+            if (withoutXTagGroups) {
+                potentialConflicts.tags.description[entrypointTagName] = [api];
+            }
+        }
+        if (!withoutXTagGroups && oasVersion !== 'oas3_2') {
+            const groupName = apiTitle || apiFilename;
+            createXTagGroups(joinedDef, groupName);
+            if (!tagDuplicate) {
+                populateXTagGroups(joinedDef, entrypointTagName, getIndexGroup(joinedDef, groupName));
+            }
+        }
+        const doesEntrypointExist = !potentialConflicts.tags.all[entrypointTagName] ||
+            (potentialConflicts.tags.all[entrypointTagName] &&
+                !potentialConflicts.tags.all[entrypointTagName].includes(api));
+        potentialConflicts.tags.all[entrypointTagName] = [
+            ...(potentialConflicts.tags.all[entrypointTagName] || []),
+            ...(!withoutXTagGroups && doesEntrypointExist ? [api] : []),
+        ];
+    }
+}
+function getIndexGroup(joinedDef, name) {
+    return joinedDef[xTagGroups].findIndex((item) => item.name === name);
+}
+function createXTagGroups(joinedDef, name) {
+    if (!joinedDef.hasOwnProperty(xTagGroups)) {
+        joinedDef[xTagGroups] = [];
+    }
+    if (!joinedDef[xTagGroups].some((g) => g.name === name)) {
+        joinedDef[xTagGroups].push({ name, tags: [] });
+    }
+    const indexGroup = getIndexGroup(joinedDef, name);
+    if (!joinedDef[xTagGroups][indexGroup].hasOwnProperty(Tags)) {
+        joinedDef[xTagGroups][indexGroup][Tags] = [];
+    }
+}
+function populateXTagGroups(joinedDef, entrypointTagName, indexGroup) {
+    if (!joinedDef[xTagGroups][indexGroup][Tags].find((t) => t.name === entrypointTagName)) {
+        joinedDef[xTagGroups][indexGroup][Tags].push(entrypointTagName);
+    }
+}
+//# sourceMappingURL=populate-tags.js.map

package/lib/commands/join/helpers/populate-tags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"populate-tags.js","sourceRoot":"","sources":["../../../../src/commands/join/helpers/populate-tags.ts"],"names":[],"mappings":"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"}

package/lib/commands/join/helpers/prefix-tag-suggestion.d.ts

@@ -0,0 +1,2 @@
+export declare function prefixTagSuggestion(conflictsLength: number): void;
+//# sourceMappingURL=prefix-tag-suggestion.d.ts.map

package/lib/commands/join/helpers/prefix-tag-suggestion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefix-tag-suggestion.d.ts","sourceRoot":"","sources":["../../../../src/commands/join/helpers/prefix-tag-suggestion.ts"],"names":[],"mappings":"AAGA,wBAAgB,mBAAmB,CAAC,eAAe,EAAE,MAAM,QAU1D"}

package/lib/commands/join/helpers/prefix-tag-suggestion.js

@@ -0,0 +1,6 @@
+import { logger } from '@redocly/openapi-core';
+import { green, blue } from 'colorette';
+export function prefixTagSuggestion(conflictsLength) {
+    logger.info(green(`\n${conflictsLength} conflict(s) on tags.\nSuggestion: please use ${blue('prefix-tags-with-filename')}, ${blue('prefix-tags-with-info-prop')} or ${blue('without-x-tag-groups')} to prevent naming conflicts.\n\n`));
+}
+//# sourceMappingURL=prefix-tag-suggestion.js.map

package/lib/commands/join/helpers/prefix-tag-suggestion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefix-tag-suggestion.js","sourceRoot":"","sources":["../../../../src/commands/join/helpers/prefix-tag-suggestion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAExC,MAAM,UAAU,mBAAmB,CAAC,eAAuB;IACzD,MAAM,CAAC,IAAI,CACT,KAAK,CACH,KAAK,eAAe,iDAAiD,IAAI,CACvE,2BAA2B,CAC5B,KAAK,IAAI,CAAC,4BAA4B,CAAC,OAAO,IAAI,CACjD,sBAAsB,CACvB,mCAAmC,CACrC,CACF,CAAC;AACJ,CAAC"}

package/lib/commands/join/helpers/replace-$-refs.d.ts

@@ -0,0 +1,2 @@
+export declare function replace$Refs(obj: unknown, componentsPrefix: string): void;
+//# sourceMappingURL=replace-$-refs.d.ts.map

package/lib/commands/join/helpers/replace-$-refs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replace-$-refs.d.ts","sourceRoot":"","sources":["../../../../src/commands/join/helpers/replace-$-refs.ts"],"names":[],"mappings":"AAKA,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,QAsBlE"}

package/lib/commands/join/helpers/replace-$-refs.js

@@ -0,0 +1,28 @@
+import { isRef, isPlainObject } from '@redocly/openapi-core';
+import * as path from 'node:path';
+import { crawl, startsWithComponents } from '../../split/index.js';
+export function replace$Refs(obj, componentsPrefix) {
+    crawl(obj, (node) => {
+        if (isRef(node) && startsWithComponents(node.$ref)) {
+            const name = path.basename(node.$ref);
+            node.$ref = node.$ref.replace(name, componentsPrefix + '_' + name);
+        }
+        else if (isPlainObject(node.discriminator) && isPlainObject(node.discriminator.mapping)) {
+            const { mapping } = node.discriminator;
+            for (const name of Object.keys(mapping)) {
+                const mappingPointer = mapping[name];
+                if (typeof mappingPointer === 'string' && startsWithComponents(mappingPointer)) {
+                    mapping[name] = mappingPointer
+                        .split('/')
+                        .map((name, i, arr) => {
+                        return arr.length - 1 === i && !name.includes(componentsPrefix)
+                            ? componentsPrefix + '_' + name
+                            : name;
+                    })
+                        .join('/');
+                }
+            }
+        }
+    });
+}
+//# sourceMappingURL=replace-$-refs.js.map

package/lib/commands/join/helpers/replace-$-refs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replace-$-refs.js","sourceRoot":"","sources":["../../../../src/commands/join/helpers/replace-$-refs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEnE,MAAM,UAAU,YAAY,CAAC,GAAY,EAAE,gBAAwB;IACjE,KAAK,CAAC,GAAG,EAAE,CAAC,IAA6B,EAAE,EAAE;QAC3C,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACnD,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACtC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,gBAAgB,GAAG,GAAG,GAAG,IAAI,CAAC,CAAC;QACrE,CAAC;aAAM,IAAI,aAAa,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC;YAC1F,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,aAAa,CAAC;YACvC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;gBACxC,MAAM,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;gBACrC,IAAI,OAAO,cAAc,KAAK,QAAQ,IAAI,oBAAoB,CAAC,cAAc,CAAC,EAAE,CAAC;oBAC/E,OAAO,CAAC,IAAI,CAAC,GAAG,cAAc;yBAC3B,KAAK,CAAC,GAAG,CAAC;yBACV,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE;wBACpB,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC;4BAC7D,CAAC,CAAC,gBAAgB,GAAG,GAAG,GAAG,IAAI;4BAC/B,CAAC,CAAC,IAAI,CAAC;oBACX,CAAC,CAAC;yBACD,IAAI,CAAC,GAAG,CAAC,CAAC;gBACf,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/lib/commands/join/helpers/show-conflicts.d.ts

@@ -0,0 +1,2 @@
+export declare function showConflicts(key: string, conflicts: any): void;
+//# sourceMappingURL=show-conflicts.d.ts.map

package/lib/commands/join/helpers/show-conflicts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"show-conflicts.d.ts","sourceRoot":"","sources":["../../../../src/commands/join/helpers/show-conflicts.ts"],"names":[],"mappings":"AAGA,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,QAIxD"}

package/lib/commands/join/helpers/show-conflicts.js

@@ -0,0 +1,8 @@
+import { logger } from '@redocly/openapi-core';
+import { red, blue } from 'colorette';
+export function showConflicts(key, conflicts) {
+    for (const [path, files] of conflicts) {
+        logger.warn(`Conflict on ${key} : ${red(path)} in files: ${blue(files)} \n`);
+    }
+}
+//# sourceMappingURL=show-conflicts.js.map

package/lib/commands/join/helpers/show-conflicts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"show-conflicts.js","sourceRoot":"","sources":["../../../../src/commands/join/helpers/show-conflicts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,UAAU,aAAa,CAAC,GAAW,EAAE,SAAc;IACvD,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,SAAS,EAAE,CAAC;QACtC,MAAM,CAAC,IAAI,CAAC,eAAe,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,cAAc,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC/E,CAAC;AACH,CAAC"}

package/lib/commands/join/index.d.ts

@@ -0,0 +1,4 @@
+import type { CommandArgs } from '../../wrapper.js';
+import type { JoinArgv } from './types.js';
+export declare function handleJoin({ argv, config, version: packageVersion, collectSpecData, }: CommandArgs<JoinArgv>): Promise<undefined>;
+//# sourceMappingURL=index.d.ts.map

package/lib/commands/join/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/join/index.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAcpD,OAAO,KAAK,EAAE,QAAQ,EAAqB,MAAM,YAAY,CAAC;AAE9D,wBAAsB,UAAU,CAAC,EAC/B,IAAI,EACJ,MAAM,EACN,OAAO,EAAE,cAAc,EACvB,eAAe,GAChB,EAAE,WAAW,CAAC,QAAQ,CAAC,sBAmLvB"}

package/lib/commands/join/index.js

@@ -0,0 +1,141 @@
+import { BaseResolver, formatProblems, getTotals, detectSpec, bundleDocument, logger, isPlainObject, isEmptyObject, getTypes, } from '@redocly/openapi-core';
+import { blue, yellow } from 'colorette';
+import * as path from 'node:path';
+import { performance } from 'node:perf_hooks';
+import { exitWithError } from '../../utils/error.js';
+import { getFallbackApisOrExit, printExecutionTime, sortTopLevelKeysForOas, getAndValidateFileExtension, writeToFileByExtension, } from '../../utils/miscellaneous.js';
+import { COMPONENTS } from '../split/types.js';
+import { replace$Refs, getInfoPrefix, getApiFilename, iteratePotentialConflicts, populateTags, collectExternalDocs, collectPaths, collectComponents, collectWebhooks, addInfoSectionAndSpecVersion, } from './helpers/index.js';
+export async function handleJoin({ argv, config, version: packageVersion, collectSpecData, }) {
+    const startedAt = performance.now();
+    const { 'prefix-components-with-info-prop': prefixComponentsWithInfoProp, 'prefix-tags-with-filename': prefixTagsWithFilename, 'prefix-tags-with-info-prop': prefixTagsWithInfoProp, 'without-x-tag-groups': withoutXTagGroups, output, } = argv;
+    const usedTagsOptions = [
+        prefixTagsWithFilename && 'prefix-tags-with-filename',
+        prefixTagsWithInfoProp && 'prefix-tags-with-info-prop',
+        withoutXTagGroups && 'without-x-tag-groups',
+    ].filter(Boolean);
+    if (usedTagsOptions.length > 1) {
+        return exitWithError(`You use ${yellow(usedTagsOptions.join(', '))} together.\nPlease choose only one!`);
+    }
+    const apis = await getFallbackApisOrExit(argv.apis, config);
+    if (apis.length < 2) {
+        return exitWithError(`At least 2 APIs should be provided.`);
+    }
+    const fileExtension = getAndValidateFileExtension(output || apis[0].path);
+    const specFilename = output || `openapi.${fileExtension}`;
+    const externalRefResolver = new BaseResolver(config.resolve);
+    const documents = await Promise.all(apis.map(({ path }) => externalRefResolver.resolveDocument(null, path, true)));
+    const decorators = new Set([
+        ...Object.keys(config.decorators.oas3_0),
+        ...Object.keys(config.decorators.oas3_1),
+        ...Object.keys(config.decorators.oas2),
+    ]);
+    config.skipDecorators(Array.from(decorators));
+    const preprocessors = new Set([
+        ...Object.keys(config.preprocessors.oas3_0),
+        ...Object.keys(config.preprocessors.oas3_1),
+        ...Object.keys(config.preprocessors.oas2),
+    ]);
+    config.skipPreprocessors(Array.from(preprocessors));
+    const bundleResults = await Promise.all(documents.map((document) => bundleDocument({
+        document,
+        config,
+        externalRefResolver: new BaseResolver(config.resolve),
+        types: getTypes(detectSpec(document.parsed)),
+    }).catch((e) => {
+        exitWithError(`${e.message}: ${blue(document.source.absoluteRef)}`);
+    })));
+    for (const { problems, bundle: document } of bundleResults) {
+        const fileTotals = getTotals(problems);
+        if (fileTotals.errors) {
+            formatProblems(problems, {
+                totals: fileTotals,
+                version: packageVersion,
+                command: 'join',
+            });
+            exitWithError(`❌ Errors encountered while bundling ${blue(document.source.absoluteRef)}: join will not proceed.`);
+        }
+    }
+    let oasVersion = null;
+    for (const document of documents) {
+        try {
+            const version = detectSpec(document.parsed);
+            collectSpecData?.(document.parsed);
+            if (version !== 'oas3_0' && version !== 'oas3_1' && version !== 'oas3_2') {
+                return exitWithError(`Only OpenAPI 3.0, 3.1, and 3.2 are supported: ${blue(document.source.absoluteRef)}.`);
+            }
+            oasVersion = oasVersion ?? version;
+            if (oasVersion !== version) {
+                return exitWithError(`All APIs must use the same OpenAPI version: ${blue(document.source.absoluteRef)}.`);
+            }
+        }
+        catch (e) {
+            return exitWithError(`${e.message}: ${blue(document.source.absoluteRef)}.`);
+        }
+    }
+    const [first, ...others] = (documents ?? []);
+    const serversAreTheSame = others.every(({ parsed: { paths, servers } }) => {
+        // include only documents with paths
+        if (!paths || isEmptyObject(paths || {})) {
+            return true;
+        }
+        return servers?.every((server) => first.parsed.servers?.find(({ url }) => url === server.url));
+    });
+    const joinedDef = {};
+    const potentialConflicts = {
+        tags: {},
+        paths: {},
+        components: {},
+        webhooks: {},
+    };
+    addInfoSectionAndSpecVersion(joinedDef, documents, prefixComponentsWithInfoProp);
+    if (serversAreTheSame && first.parsed.servers) {
+        joinedDef.servers = first.parsed.servers;
+    }
+    for (const document of documents) {
+        const openapi = isPlainObject(document.parsed)
+            ? document.parsed
+            : {};
+        const { tags, info } = openapi;
+        const api = path.relative(process.cwd(), document.source.absoluteRef);
+        const apiFilename = getApiFilename(api);
+        const tagsPrefix = prefixTagsWithFilename
+            ? apiFilename
+            : getInfoPrefix(info, prefixTagsWithInfoProp, 'tags');
+        const componentsPrefix = getInfoPrefix(info, prefixComponentsWithInfoProp, COMPONENTS);
+        if (openapi.hasOwnProperty('x-tagGroups')) {
+            logger.warn(`warning: x-tagGroups at ${blue(api)} will be skipped \n`);
+        }
+        const context = {
+            api,
+            apiFilename,
+            apiTitle: info?.title,
+            tags,
+            potentialConflicts,
+            tagsPrefix,
+            componentsPrefix,
+            oasVersion,
+        };
+        if (tags) {
+            populateTags({ joinedDef, withoutXTagGroups, context });
+        }
+        collectExternalDocs({ joinedDef, openapi, context });
+        collectPaths({ joinedDef, withoutXTagGroups, openapi, context, serversAreTheSame });
+        collectComponents({ joinedDef, openapi, context });
+        collectWebhooks({ joinedDef, withoutXTagGroups, openapi, context });
+        if (componentsPrefix) {
+            replace$Refs(openapi, componentsPrefix);
+        }
+    }
+    const potentialConflictsTotal = iteratePotentialConflicts({
+        potentialConflicts,
+        withoutXTagGroups,
+    });
+    const noRefs = true;
+    if (potentialConflictsTotal) {
+        return exitWithError(`Please fix conflicts before running ${yellow('join')}.`);
+    }
+    writeToFileByExtension(sortTopLevelKeysForOas(joinedDef), specFilename, noRefs);
+    printExecutionTime('join', startedAt, specFilename);
+}
+//# sourceMappingURL=index.js.map

package/lib/commands/join/index.js.map

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

package/lib/commands/join/types.d.ts

@@ -0,0 +1,22 @@
+import type { Oas3Definition, Oas3_1Definition, Oas3_2Definition, Oas3Tag, Oas3_2Tag, SpecVersion } from '@redocly/openapi-core';
+import type { VerifyConfigOptions } from '../../types.js';
+export type AnyOas3Definition = Oas3Definition | Oas3_1Definition | Oas3_2Definition;
+export type JoinDocumentContext = {
+    api: string;
+    apiFilename: string;
+    apiTitle?: string;
+    tags?: (Oas3Tag | Oas3_2Tag)[];
+    potentialConflicts: any;
+    tagsPrefix: string;
+    componentsPrefix: string | undefined;
+    oasVersion: Extract<SpecVersion, 'oas3_0' | 'oas3_1' | 'oas3_2'> | null;
+};
+export type JoinArgv = {
+    apis: string[];
+    'prefix-tags-with-info-prop'?: string;
+    'prefix-tags-with-filename'?: boolean;
+    'prefix-components-with-info-prop'?: string;
+    'without-x-tag-groups'?: boolean;
+    output?: string;
+} & VerifyConfigOptions;
+//# sourceMappingURL=types.d.ts.map

package/lib/commands/join/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/commands/join/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,OAAO,EACP,SAAS,EACT,WAAW,EACZ,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1D,MAAM,MAAM,iBAAiB,GAAG,cAAc,GAAG,gBAAgB,GAAG,gBAAgB,CAAC;AAErF,MAAM,MAAM,mBAAmB,GAAG;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,CAAC,OAAO,GAAG,SAAS,CAAC,EAAE,CAAC;IAC/B,kBAAkB,EAAE,GAAG,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,UAAU,EAAE,OAAO,CAAC,WAAW,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC,GAAG,IAAI,CAAC;CACzE,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,4BAA4B,CAAC,EAAE,MAAM,CAAC;IACtC,2BAA2B,CAAC,EAAE,OAAO,CAAC;IACtC,kCAAkC,CAAC,EAAE,MAAM,CAAC;IAC5C,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,mBAAmB,CAAC"}

package/lib/commands/join/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/lib/commands/join/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/commands/join/types.ts"],"names":[],"mappings":""}

package/lib/commands/{stats.d.ts → stats/index.d.ts}

@@ -1,9 +1,9 @@
 import type { OutputFormat } from '@redocly/openapi-core';
-import type { VerifyConfigOptions } from '../types.js';
-import type { CommandArgs } from '../wrapper.js';
+import type { VerifyConfigOptions } from '../../types.js';
+import type { CommandArgs } from '../../wrapper.js';
 export type StatsArgv = {
     api?: string;
     format: OutputFormat;
 } & VerifyConfigOptions;
 export declare function handleStats({ argv, config, collectSpecData }: CommandArgs<StatsArgv>): Promise<void>;
-//# sourceMappingURL=stats.d.ts.map
+//# sourceMappingURL=index.d.ts.map

package/lib/commands/stats/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/stats/index.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAIV,YAAY,EACb,MAAM,uBAAuB,CAAC;AAI/B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AA0DpD,MAAM,MAAM,SAAS,GAAG;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,YAAY,CAAC;CACtB,GAAG,mBAAmB,CAAC;AAExB,wBAAsB,WAAW,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,eAAe,EAAE,EAAE,WAAW,CAAC,SAAS,CAAC,iBA4C1F"}

package/lib/commands/{stats.js → stats/index.js}

@@ -1,30 +1,23 @@
-import { normalizeTypes, BaseResolver, resolveDocument, detectSpec, getTypes, normalizeVisitors, walkDocument, Stats, bundle, logger, } from '@redocly/openapi-core';
+import { normalizeTypes, BaseResolver, resolveDocument, detectSpec, getTypes, normalizeVisitors, walkDocument, bundle, logger, } from '@redocly/openapi-core';
 import * as colors from 'colorette';
 import { performance } from 'perf_hooks';
-import { getFallbackApisOrExit, printExecutionTime } from '../utils/miscellaneous.js';
-const statsAccumulator = {
-    refs: { metric: '🚗 References', total: 0, color: 'red', items: new Set() },
-    externalDocs: { metric: '📦 External Documents', total: 0, color: 'magenta' },
-    schemas: { metric: '📈 Schemas', total: 0, color: 'white' },
-    parameters: { metric: '👉 Parameters', total: 0, color: 'yellow', items: new Set() },
-    links: { metric: '🔗 Links', total: 0, color: 'cyan', items: new Set() },
-    pathItems: { metric: '🔀 Path Items', total: 0, color: 'green' },
-    webhooks: { metric: '🎣 Webhooks', total: 0, color: 'green' },
-    operations: { metric: '👷 Operations', total: 0, color: 'yellow' },
-    tags: { metric: '🔖 Tags', total: 0, color: 'white', items: new Set() },
-};
+import { getFallbackApisOrExit, printExecutionTime } from '../../utils/miscellaneous.js';
+import { resolveStatsVisitorAndAccumulator } from './visitor-and-accumulator-resolver.js';
 function printStatsStylish(statsAccumulator) {
     for (const node in statsAccumulator) {
-        const { metric, total, color } = statsAccumulator[node];
-        logger.output(colors[color](`${metric}: ${total} \n`));
+        const stat = statsAccumulator[node];
+        const { metric, total, color } = stat;
+        const colorFn = colors[color];
+        logger.output(colorFn(`${metric}: ${total} \n`));
     }
 }
 function printStatsJson(statsAccumulator) {
     const json = {};
     for (const key of Object.keys(statsAccumulator)) {
+        const stat = statsAccumulator[key];
         json[key] = {
-            metric: statsAccumulator[key].metric,
-            total: statsAccumulator[key].total,
+            metric: stat.metric,
+            total: stat.total,
         };
     }
     logger.output(JSON.stringify(json, null, 2));
@@ -32,12 +25,8 @@ function printStatsJson(statsAccumulator) {
 function printStatsMarkdown(statsAccumulator) {
     let output = '| Feature  | Count  |\n| --- | --- |\n';
     for (const key of Object.keys(statsAccumulator)) {
-        output +=
-            '| ' +
-                statsAccumulator[key].metric +
-                ' | ' +
-                statsAccumulator[key].total +
-                ' |\n';
+        const stat = statsAccumulator[key];
+        output += '| ' + stat.metric + ' | ' + stat.total + ' |\n';
     }
     logger.output(output);
 }
@@ -63,6 +52,7 @@ export async function handleStats({ argv, config, collectSpecData }) {
     collectSpecData?.(document.parsed);
     const specVersion = detectSpec(document.parsed);
     const types = normalizeTypes(config.extendTypes(getTypes(specVersion), specVersion), config);
+    const { statsVisitor, statsAccumulator } = resolveStatsVisitorAndAccumulator(specVersion);
     const startedAt = performance.now();
     const ctx = {
         problems: [],
@@ -75,20 +65,20 @@ export async function handleStats({ argv, config, collectSpecData }) {
         rootType: types.Root,
         externalRefResolver,
     });
-    const statsVisitor = normalizeVisitors([
+    const normalizedStatsVisitor = normalizeVisitors([
         {
             severity: 'warn',
             ruleId: 'stats',
-            visitor: Stats(statsAccumulator),
+            visitor: statsVisitor,
         },
     ], types);
     walkDocument({
         document,
         rootType: types.Root,
-        normalizedVisitors: statsVisitor,
+        normalizedVisitors: normalizedStatsVisitor,
         resolvedRefMap,
         ctx,
     });
     printStats(statsAccumulator, path, startedAt, argv.format);
 }
-//# sourceMappingURL=stats.js.map
+//# sourceMappingURL=index.js.map

package/lib/commands/stats/index.js.map

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