@ama-openapi/redocly-plugin 13.5.0-prerelease.20 → 13.5.0-prerelease.21

package/README.md

@@ -106,6 +106,12 @@ The following environment variables are supported:
 | `AMA_OPENAPI_REDOCLY_VERBOSE` | Display debug level logs | `false` |
 | `AMA_OPENAPI_REDOCLY_QUIET` | Suppress all output| `false` |
 
+## Additional custom decorators
+
+The plugin offer additional [Redocly decorator](https://redocly.com/docs/cli/decorators) which can be selected and configured in [Redocly configuration](https://redocly.com/docs/cli/rules/configure-rules).
+
+The full list of available decorators, along with their options, is provided in the [dedicated documentation](https://github.com/AmadeusITGroup/otter/blob/main/docs/redocly/DECORATORS.md).
+
 ## Integration
 
 This Redocly Plugin is designed to work with the following tools:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ama-openapi/redocly-plugin",
-  "version": "13.5.0-prerelease.20",
+  "version": "13.5.0-prerelease.21",
   "type": "module",
   "publishConfig": {
     "access": "public"
@@ -30,13 +30,13 @@
     "postbuild": "patch-package-json-main"
   },
   "dependencies": {
-    "@ama-openapi/core": "~13.5.0-prerelease.20",
+    "@ama-openapi/core": "~13.5.0-prerelease.21",
     "dotenv": "~17.2.3",
     "tslib": "^2.6.2",
     "yargs": "~18.0.0"
   },
   "peerDependencies": {
-    "@o3r/telemetry": "~13.5.0-prerelease.20",
+    "@o3r/telemetry": "~13.5.0-prerelease.21",
     "@redocly/openapi-core": "^2.11.0"
   },
   "peerDependenciesMeta": {
@@ -54,10 +54,10 @@
     "@nx/eslint-plugin": "~21.6.0",
     "@nx/jest": "~21.6.0",
     "@nx/js": "~21.6.0",
-    "@o3r/build-helpers": "~13.5.0-prerelease.20",
-    "@o3r/eslint-plugin": "~13.5.0-prerelease.20",
-    "@o3r/telemetry": "~13.5.0-prerelease.20",
-    "@o3r/test-helpers": "~13.5.0-prerelease.20",
+    "@o3r/build-helpers": "~13.5.0-prerelease.21",
+    "@o3r/eslint-plugin": "~13.5.0-prerelease.21",
+    "@o3r/telemetry": "~13.5.0-prerelease.21",
+    "@o3r/test-helpers": "~13.5.0-prerelease.21",
     "@redocly/openapi-core": "~2.11.0",
     "@stylistic/eslint-plugin": "~5.6.0",
     "@types/jest": "~29.5.2",

package/src/plugin.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.mts","sourceRoot":"","sources":["../../src/plugin.mts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,MAAM,EACZ,MAAM,uBAAuB,CAAC;AAO/B,OAAO,EAEL,KAAK,yBAAyB,EAC/B,MAAM,6CAA6C,CAAC;AAIrD,qCAAqC;AACrC,MAAM,WAAW,uBAAwB,SAAQ,OAAO,CAAC,yBAAyB,CAAC;CAClF;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAAU,UAAU,uBAAuB,KAAG,OAAO,CAAC,MAAM,CAkBxF,CAAC"}
+{"version":3,"file":"plugin.d.mts","sourceRoot":"","sources":["../../src/plugin.mts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,MAAM,EACZ,MAAM,uBAAuB,CAAC;AAe/B,OAAO,EAEL,KAAK,yBAAyB,EAC/B,MAAM,6CAA6C,CAAC;AAIrD,qCAAqC;AACrC,MAAM,WAAW,uBAAwB,SAAQ,OAAO,CAAC,yBAAyB,CAAC;CAClF;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAAU,UAAU,uBAAuB,KAAG,OAAO,CAAC,MAAM,CAiCxF,CAAC"}

package/src/plugin.mjs

@@ -1,5 +1,7 @@
 import { config, } from 'dotenv';
 import { ENVIRONMENT_VARIABLE_PREFIX, } from './constants.mjs';
+import { DECORATOR_ID_REDIRECT_REF, redirectRefsDecorator, } from './plugins/decorators/common/replace-refs/replace-refs.decorator.mjs';
+import { DECORATOR_ID_REMOVE_UNUSED_COMPONENT, removeUnusedComponentsDecorator, } from './plugins/decorators/oas3/remove-unused-components/remove-unused-components.decorator.mjs';
 import { retrieveDependency, } from './plugins/meta/retrieve-dependency.meta.mjs';
 const DEFAULT_OPTIONS = 'error';
 /**
@@ -15,7 +17,22 @@ export const amaOpenapiPlugin = async (options) => {
         continueOnError: continueOnError ? continueOnError === 'true' : options?.continueOnError ?? false
     });
     return {
-        id: 'ama-openapi'
+        id: 'ama-openapi',
+        decorators: {
+            oas2: {
+                [DECORATOR_ID_REDIRECT_REF]: redirectRefsDecorator
+            },
+            oas3: {
+                [DECORATOR_ID_REDIRECT_REF]: redirectRefsDecorator,
+                [DECORATOR_ID_REMOVE_UNUSED_COMPONENT]: removeUnusedComponentsDecorator
+            },
+            async2: {
+                [DECORATOR_ID_REDIRECT_REF]: redirectRefsDecorator
+            },
+            async3: {
+                [DECORATOR_ID_REDIRECT_REF]: redirectRefsDecorator
+            }
+        }
     };
 };
 //# sourceMappingURL=plugin.mjs.map

package/src/plugin.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.mjs","sourceRoot":"","sources":["../../src/plugin.mts"],"names":[],"mappings":"AAMA,OAAO,EACL,MAAM,GACP,MAAM,QAAQ,CAAC;AAChB,OAAO,EACL,2BAA2B,GAC5B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,kBAAkB,GAEnB,MAAM,6CAA6C,CAAC;AAErD,MAAM,eAAe,GAAa,OAAO,CAAC;AAM1C;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,EAAE,OAAiC,EAAmB,EAAE;IAC3F,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAExC,MAAM,EACJ,CAAC,GAAG,2BAA2B,UAAU,CAAC,EAAE,OAAO,EACnD,CAAC,GAAG,2BAA2B,QAAQ,CAAC,EAAE,KAAK,EAC/C,CAAC,GAAG,2BAA2B,oBAAoB,CAAC,EAAE,eAAe,EACtE,GAAG,OAAO,CAAC,GAAG,CAAC;IAEhB,MAAM,kBAAkB,CAAC;QACvB,QAAQ,EAAE,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,QAAQ,IAAI,eAAe,CAAC;QAC/E,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,KAAK,IAAI,KAAK;QACzD,eAAe,EAAE,eAAe,CAAC,CAAC,CAAC,eAAe,KAAK,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,eAAe,IAAI,KAAK;KAClG,CAAC,CAAC;IAEH,OAAO;QACL,EAAE,EAAE,aAAa;KAClB,CAAC;AACJ,CAAC,CAAC"}
+{"version":3,"file":"plugin.mjs","sourceRoot":"","sources":["../../src/plugin.mts"],"names":[],"mappings":"AAMA,OAAO,EACL,MAAM,GACP,MAAM,QAAQ,CAAC;AAChB,OAAO,EACL,2BAA2B,GAC5B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,qEAAqE,CAAC;AAC7E,OAAO,EACL,oCAAoC,EACpC,+BAA+B,GAChC,MAAM,2FAA2F,CAAC;AACnG,OAAO,EACL,kBAAkB,GAEnB,MAAM,6CAA6C,CAAC;AAErD,MAAM,eAAe,GAAa,OAAO,CAAC;AAM1C;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,EAAE,OAAiC,EAAmB,EAAE;IAC3F,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAExC,MAAM,EACJ,CAAC,GAAG,2BAA2B,UAAU,CAAC,EAAE,OAAO,EACnD,CAAC,GAAG,2BAA2B,QAAQ,CAAC,EAAE,KAAK,EAC/C,CAAC,GAAG,2BAA2B,oBAAoB,CAAC,EAAE,eAAe,EACtE,GAAG,OAAO,CAAC,GAAG,CAAC;IAEhB,MAAM,kBAAkB,CAAC;QACvB,QAAQ,EAAE,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,QAAQ,IAAI,eAAe,CAAC;QAC/E,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,KAAK,IAAI,KAAK;QACzD,eAAe,EAAE,eAAe,CAAC,CAAC,CAAC,eAAe,KAAK,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,eAAe,IAAI,KAAK;KAClG,CAAC,CAAC;IAEH,OAAO;QACL,EAAE,EAAE,aAAa;QACjB,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,CAAC,yBAAyB,CAAC,EAAE,qBAAqB;aACnD;YACD,IAAI,EAAE;gBACJ,CAAC,yBAAyB,CAAC,EAAE,qBAAqB;gBAClD,CAAC,oCAAoC,CAAC,EAAE,+BAA+B;aACxE;YACD,MAAM,EAAE;gBACN,CAAC,yBAAyB,CAAC,EAAE,qBAAqB;aACnD;YACD,MAAM,EAAE;gBACN,CAAC,yBAAyB,CAAC,EAAE,qBAAqB;aACnD;SACF;KACF,CAAC;AACJ,CAAC,CAAC"}

package/src/plugins/decorators/common/replace-refs/replace-refs.decorator.d.mts

@@ -0,0 +1,46 @@
+import type { Async2Preprocessor, Async3Preprocessor, Oas2Preprocessor, Oas3Preprocessor } from '@redocly/openapi-core';
+type Preprocessor = Oas2Preprocessor & Oas3Preprocessor & Async2Preprocessor & Async3Preprocessor;
+interface RedirectCriteria {
+    /** Pattern, or one of the listed patterns, the $ref url should match to apply the redirection */
+    includeRefPatterns?: string | string[];
+    /** Pattern, or one of the listed patterns, the $ref url should not match to apply the redirection */
+    excludeRefPatterns?: string | string[];
+    /** Detect if a specific `x-vendor` tag is present beside of the reference */
+    hasTag?: string;
+}
+/** Rule to redirect the reference matching the criteria in the final specification */
+export interface RedirectRule extends RedirectCriteria {
+    /** Redirect the reference to a define URL */
+    redirectUrl: string;
+    /** Determine the final inner path should be kept */
+    keepFinalInnerPath?: boolean;
+}
+/** Options for the RedirectRefs custom decorator */
+export interface RedirectRefDecoratorOptions {
+    /** Rules to be apply to the specification references */
+    rules?: RedirectRule[];
+}
+/** Name of the redirectRef custom decorator */
+export declare const DECORATOR_ID_REDIRECT_REF = "redirect-ref";
+/**
+ * Custom decorator to redirect the references in the final specification
+ * @example Redirect specific model to external URL
+ * ```yaml
+ * plugins:
+ *   - '@ama-openapi/redocly-plugin'
+ *
+ * apis:
+ *   mySpec:
+ *     root: apis/mySpec.json
+ *     decorators:
+ *       ama-openapi/redirect-ref:
+ *         rules:
+ *          - redirectUrl: "https://my-spec.website.com/"
+ *            keepFinalInnerPath: true
+ *            matchingRefPattern: "my-models/.*"
+ * ```
+ * @param options
+ */
+export declare const redirectRefsDecorator: Preprocessor;
+export {};
+//# sourceMappingURL=replace-refs.decorator.d.mts.map

package/src/plugins/decorators/common/replace-refs/replace-refs.decorator.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replace-refs.decorator.d.mts","sourceRoot":"","sources":["../../../../../../src/plugins/decorators/common/replace-refs/replace-refs.decorator.mts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,uBAAuB,CAAC;AAE/B,KAAK,YAAY,GAAG,gBAAgB,GAAG,gBAAgB,GAAG,kBAAkB,GAAG,kBAAkB,CAAC;AAElG,UAAU,gBAAgB;IACxB,iGAAiG;IACjG,kBAAkB,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACvC,qGAAqG;IACrG,kBAAkB,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACvC,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,sFAAsF;AACtF,MAAM,WAAW,YAAa,SAAQ,gBAAgB;IACpD,6CAA6C;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,oDAAoD;AACpD,MAAM,WAAW,2BAA2B;IAC1C,wDAAwD;IACxD,KAAK,CAAC,EAAE,YAAY,EAAE,CAAC;CACxB;AAED,+CAA+C;AAC/C,eAAO,MAAM,yBAAyB,iBAAiB,CAAC;AAQxD;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,qBAAqB,EAAE,YA+BnC,CAAC"}

package/src/plugins/decorators/common/replace-refs/replace-refs.decorator.mjs

@@ -0,0 +1,55 @@
+/** Name of the redirectRef custom decorator */
+export const DECORATOR_ID_REDIRECT_REF = 'redirect-ref';
+const regExpify = (patterns) => patterns
+    ? (Array.isArray(patterns) ? patterns : [patterns])
+        .map((pattern) => new RegExp(pattern))
+    : undefined;
+/**
+ * Custom decorator to redirect the references in the final specification
+ * @example Redirect specific model to external URL
+ * ```yaml
+ * plugins:
+ *   - '@ama-openapi/redocly-plugin'
+ *
+ * apis:
+ *   mySpec:
+ *     root: apis/mySpec.json
+ *     decorators:
+ *       ama-openapi/redirect-ref:
+ *         rules:
+ *          - redirectUrl: "https://my-spec.website.com/"
+ *            keepFinalInnerPath: true
+ *            matchingRefPattern: "my-models/.*"
+ * ```
+ * @param options
+ */
+export const redirectRefsDecorator = (options) => {
+    const rules = options.rules?.map((rule) => {
+        return {
+            ...rule,
+            include: regExpify(rule.includeRefPatterns),
+            exclude: regExpify(rule.excludeRefPatterns)
+        };
+    }) ?? [];
+    const toRedirectMap = new Map();
+    return {
+        ref: {
+            enter: (node, { parent, location }) => {
+                const matchingRule = rules.find(({ include, exclude, hasTag }) => ([include, exclude, hasTag].some((item) => !!item))
+                    && (!include || include.some((regExp) => node.$ref.match(regExp)))
+                    && (!exclude || !exclude.some((regExp) => node.$ref.match(regExp)))
+                    && (!hasTag || Object.values(parent).some((obj) => obj && typeof obj === 'object' && typeof obj[hasTag] !== 'undefined' && !!obj[hasTag])));
+                if (matchingRule) {
+                    toRedirectMap.set(location.absolutePointer, matchingRule);
+                }
+            },
+            leave: (node, { location }) => {
+                const toRedirect = toRedirectMap.get(location.absolutePointer);
+                if (toRedirect) {
+                    node.$ref = toRedirect.redirectUrl + (toRedirect.keepFinalInnerPath ? node.$ref : '');
+                }
+            }
+        }
+    };
+};
+//# sourceMappingURL=replace-refs.decorator.mjs.map

package/src/plugins/decorators/common/replace-refs/replace-refs.decorator.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"replace-refs.decorator.mjs","sourceRoot":"","sources":["../../../../../../src/plugins/decorators/common/replace-refs/replace-refs.decorator.mts"],"names":[],"mappings":"AAgCA,+CAA+C;AAC/C,MAAM,CAAC,MAAM,yBAAyB,GAAG,cAAc,CAAC;AAExD,MAAM,SAAS,GAAG,CAAC,QAAuC,EAAE,EAAE,CAC5D,QAAQ;IACN,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;SAChD,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC,CAAC,SAAS,CAAC;AAEhB;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAiB,CAAC,OAAoC,EAAE,EAAE;IAC1F,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACxC,OAAO;YACL,GAAG,IAAI;YACP,OAAO,EAAE,SAAS,CAAC,IAAI,CAAC,kBAAkB,CAAC;YAC3C,OAAO,EAAE,SAAS,CAAC,IAAI,CAAC,kBAAkB,CAAC;SAC5C,CAAC;IACJ,CAAC,CAAC,IAAI,EAAE,CAAC;IACT,MAAM,aAAa,GAAG,IAAI,GAAG,EAAwB,CAAC;IACtD,OAAO;QACL,GAAG,EAAE;YACH,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE;gBACpC,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,CAC/D,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;uBAChD,CAAC,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;uBAC/D,CAAC,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;uBAChE,CAAC,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,GAAQ,EAAE,EAAE,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,OAAO,GAAG,CAAC,MAAM,CAAC,KAAK,WAAW,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAChJ,CAAC;gBACF,IAAI,YAAY,EAAE,CAAC;oBACjB,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,eAAe,EAAE,YAAY,CAAC,CAAC;gBAC5D,CAAC;YACH,CAAC;YACD,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;gBAC5B,MAAM,UAAU,GAAG,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;gBAE/D,IAAI,UAAU,EAAE,CAAC;oBACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC,WAAW,GAAG,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBACxF,CAAC;YACH,CAAC;SACF;KACF,CAAC;AACJ,CAAC,CAAC"}

package/src/plugins/decorators/oas3/remove-unused-components/remove-unused-components.decorator.d.mts

@@ -0,0 +1,12 @@
+import { type Oas3Preprocessor } from '@redocly/openapi-core';
+/** Name of the removeUnusedComponents custom decorator */
+export declare const DECORATOR_ID_REMOVE_UNUSED_COMPONENT = "remove-unused-component";
+/**
+ * This decorator remove the components not referred in the bundled specification
+ *
+ * Note:
+ * The purpose of this plugin is to support inter dependencies not supported currently by the Redocly built-in `remove-unused-components`.
+ * This plugin will be deprecated in favor to the built-in plugin when issue https://github.com/Redocly/redocly-cli/issues/1783 is fixed
+ */
+export declare const removeUnusedComponentsDecorator: Oas3Preprocessor;
+//# sourceMappingURL=remove-unused-components.decorator.d.mts.map

package/src/plugins/decorators/oas3/remove-unused-components/remove-unused-components.decorator.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove-unused-components.decorator.d.mts","sourceRoot":"","sources":["../../../../../../src/plugins/decorators/oas3/remove-unused-components/remove-unused-components.decorator.mts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,gBAAgB,EAEtB,MAAM,uBAAuB,CAAC;AAE/B,0DAA0D;AAC1D,eAAO,MAAM,oCAAoC,4BAA4B,CAAC;AAE9E;;;;;;GAMG;AACH,eAAO,MAAM,+BAA+B,EAAE,gBA+F7C,CAAC"}

package/src/plugins/decorators/oas3/remove-unused-components/remove-unused-components.decorator.mjs

@@ -0,0 +1,103 @@
+import { logger, } from '@redocly/openapi-core';
+/** Name of the removeUnusedComponents custom decorator */
+export const DECORATOR_ID_REMOVE_UNUSED_COMPONENT = 'remove-unused-component';
+/**
+ * This decorator remove the components not referred in the bundled specification
+ *
+ * Note:
+ * The purpose of this plugin is to support inter dependencies not supported currently by the Redocly built-in `remove-unused-components`.
+ * This plugin will be deprecated in favor to the built-in plugin when issue https://github.com/Redocly/redocly-cli/issues/1783 is fixed
+ */
+export const removeUnusedComponentsDecorator = () => {
+    const refMaps = new Map();
+    const registerComponent = (node, ctx) => {
+        const rec = (obj) => {
+            if (obj && typeof obj === 'object' && obj.$ref && !ctx.location.absolutePointer.endsWith(obj.$ref)) {
+                if (refMaps.has(obj.$ref)) {
+                    const refs = refMaps.get(obj.$ref);
+                    if (!refs.includes(ctx.location.absolutePointer)) {
+                        return refMaps.set(obj.$ref, [...refs, ctx.location.absolutePointer]);
+                    }
+                }
+                else {
+                    return refMaps.set(obj.$ref, [ctx.location.absolutePointer]);
+                }
+            }
+            if (typeof obj === 'object') {
+                if (Array.isArray(obj)) {
+                    obj.forEach((item) => rec(item));
+                }
+                else if (obj) {
+                    Object.values(obj).forEach((value) => rec(value));
+                }
+            }
+        };
+        rec(node);
+    };
+    return {
+        Paths: {
+            leave: registerComponent
+        },
+        NamedSchemas: {
+            Schema: registerComponent
+        },
+        NamedParameters: {
+            Parameter: registerComponent
+        },
+        NamedResponses: {
+            Response: registerComponent
+        },
+        NamedExamples: {
+            Example: registerComponent
+        },
+        NamedRequestBodies: {
+            RequestBody: registerComponent
+        },
+        NamedHeaders: {
+            Header: registerComponent
+        },
+        Components: {
+            leave: (node, ctx) => {
+                const removeUnusedSchemas = () => {
+                    if (!node.schemas) {
+                        return 0;
+                    }
+                    const toRemoveSchemaNames = Object.keys(node.schemas)
+                        .filter((name) => !refMaps.has(`#/components/schemas/${name}`));
+                    toRemoveSchemaNames
+                        .forEach((name) => {
+                        delete node.schemas[name];
+                        const elementRef = `${ctx.location.absolutePointer}/schemas/${name}`;
+                        refMaps.forEach((locations, ref) => {
+                            if (locations.includes(elementRef)) {
+                                locations = locations.filter((location) => location !== elementRef);
+                                if (locations.length === 0) {
+                                    refMaps.delete(ref);
+                                }
+                                else {
+                                    refMaps.set(ref, locations);
+                                }
+                            }
+                        });
+                    });
+                    return toRemoveSchemaNames.length > 0 ? toRemoveSchemaNames.length + removeUnusedSchemas() : 0;
+                };
+                const removedCount = removeUnusedSchemas();
+                if (node.schemas && Object.keys(node.schemas).length === 0) {
+                    delete node.schemas;
+                }
+                if (removedCount > 0) {
+                    logger.info(`Removed ${removedCount} unused components`);
+                }
+            }
+        },
+        Root: {
+            leave: (root) => {
+                if (root.components && Object.keys(root.components).length === 0) {
+                    delete root.components;
+                }
+            }
+        }
+    };
+};
+//# sourceMappingURL=remove-unused-components.decorator.mjs.map

package/src/plugins/decorators/oas3/remove-unused-components/remove-unused-components.decorator.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove-unused-components.decorator.mjs","sourceRoot":"","sources":["../../../../../../src/plugins/decorators/oas3/remove-unused-components/remove-unused-components.decorator.mts"],"names":[],"mappings":"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"}

package/src/plugins/meta/retrieve-dependency.meta.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"retrieve-dependency.meta.d.mts","sourceRoot":"","sources":["../../../../src/plugins/meta/retrieve-dependency.meta.mts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,0BAA0B,EAC/B,KAAK,QAAQ,EAEd,MAAM,mBAAmB,CAAC;AAE3B;;GAEG;AACH,MAAM,WAAW,yBAA0B,SAAQ,0BAA0B;IAC3E;;;OAGG;IACH,QAAQ,EAAE,QAAQ,CAAC;IAEnB,0BAA0B;IAC1B,KAAK,EAAE,OAAO,CAAC;IAEf,8CAA8C;IAC9C,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAAU,SAAS,yBAAyB,kBAY1E,CAAC"}
+{"version":3,"file":"retrieve-dependency.meta.d.mts","sourceRoot":"","sources":["../../../../src/plugins/meta/retrieve-dependency.meta.mts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,0BAA0B,EAC/B,KAAK,QAAQ,EAEd,MAAM,mBAAmB,CAAC;AAK3B;;GAEG;AACH,MAAM,WAAW,yBAA0B,SAAQ,0BAA0B;IAC3E;;;OAGG;IACH,QAAQ,EAAE,QAAQ,CAAC;IAEnB,0BAA0B;IAC1B,KAAK,EAAE,OAAO,CAAC;IAEf,8CAA8C;IAC9C,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAAU,SAAS,yBAAyB,kBAY1E,CAAC"}

package/src/plugins/meta/retrieve-dependency.meta.mjs

@@ -1,19 +1,20 @@
 import { getLogger, installDependencies,
 // eslint-disable-next-line import/no-unresolved -- Cannot resolve mjs file in current setup (see #3738)
  } from '@ama-openapi/core';
+import { logger, } from '@redocly/openapi-core';
 /**
  * Retrieve dependencies according to manifest files.
  * Refer to {@link InstallDependencies} for more information
  * @param options
  */
 export const retrieveDependency = async (options) => {
-    const logger = options.quiet ? undefined : getLogger(options.logLevel);
+    const amaLogger = options.quiet ? undefined : getLogger(options.logLevel, logger);
     try {
-        await installDependencies(process.cwd(), { ...options, logger });
+        await installDependencies(process.cwd(), { ...options, logger: amaLogger });
     }
     catch (e) {
         if (options?.continueOnError) {
-            logger?.error(e);
+            amaLogger?.error(e);
         }
         else {
             throw e;

package/src/plugins/meta/retrieve-dependency.meta.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"retrieve-dependency.meta.mjs","sourceRoot":"","sources":["../../../../src/plugins/meta/retrieve-dependency.meta.mts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,mBAAmB;AAGnB,wGAAwG;EACzG,MAAM,mBAAmB,CAAC;AAmB3B;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,EAAE,OAAkC,EAAE,EAAE;IAC7E,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEvE,IAAI,CAAC;QACH,MAAM,mBAAmB,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IACnE,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,OAAO,EAAE,eAAe,EAAE,CAAC;YAC7B,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;QACnB,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,CAAC;QACV,CAAC;IACH,CAAC;AACH,CAAC,CAAC"}
+{"version":3,"file":"retrieve-dependency.meta.mjs","sourceRoot":"","sources":["../../../../src/plugins/meta/retrieve-dependency.meta.mts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,mBAAmB;AAGnB,wGAAwG;EACzG,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,MAAM,GACP,MAAM,uBAAuB,CAAC;AAmB/B;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,EAAE,OAAkC,EAAE,EAAE;IAC7E,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAElF,IAAI,CAAC;QACH,MAAM,mBAAmB,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;IAC9E,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,OAAO,EAAE,eAAe,EAAE,CAAC;YAC7B,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,CAAC;QACV,CAAC;IACH,CAAC;AACH,CAAC,CAAC"}