@speclynx/apidom-ns-openapi-2 2.13.1 → 3.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@speclynx/apidom-ns-openapi-2",
-  "version": "2.13.1",
+  "version": "3.1.0",
   "description": "OpenAPI 2.0 namespace for ApiDOM.",
   "publishConfig": {
     "access": "public",
@@ -43,11 +43,11 @@
   "license": "Apache-2.0",
   "dependencies": {
     "@babel/runtime-corejs3": "^7.28.4",
-    "@speclynx/apidom-core": "2.13.1",
-    "@speclynx/apidom-datamodel": "2.13.1",
-    "@speclynx/apidom-error": "2.13.1",
-    "@speclynx/apidom-ns-json-schema-draft-4": "2.13.1",
-    "@speclynx/apidom-traverse": "2.13.1",
+    "@speclynx/apidom-core": "3.1.0",
+    "@speclynx/apidom-datamodel": "3.1.0",
+    "@speclynx/apidom-error": "3.1.0",
+    "@speclynx/apidom-ns-json-schema-draft-4": "3.1.0",
+    "@speclynx/apidom-traverse": "3.1.0",
     "ramda": "~0.32.0",
     "ramda-adjunct": "^6.0.0",
     "ts-mixer": "^6.0.4"
@@ -62,5 +62,5 @@
     "README.md",
     "CHANGELOG.md"
   ],
-  "gitHead": "7a15e77dd776ef85f3e4421f0b4be52362b16f68"
+  "gitHead": "c0807dd0b7770eaaf594bd0013be65e2c28c504a"
 }

package/src/index.cjs

@@ -3,12 +3,13 @@
 var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
 var _interopRequireWildcard = require("@babel/runtime-corejs3/helpers/interopRequireWildcard").default;
 exports.__esModule = true;
-exports.refractOperation = exports.refractLicense = exports.refractItems = exports.refractInfo = exports.refractHeaders = exports.refractHeader = exports.refractExternalDocumentation = exports.refractExample = exports.refractDefinitions = exports.refractContact = exports.refract = exports.mediaTypes = exports.isXmlElement = exports.isTagElement = exports.isSwaggerVersionElement = exports.isSwaggerExtension = exports.isSwaggerElement = exports.isSecuritySchemeElement = exports.isSecurityRequirementElement = exports.isSecurityDefinitionsElement = exports.isScopesElement = exports.isSchemaElement = exports.isResponsesElement = exports.isResponsesDefinitionsElement = exports.isResponseElement = exports.isReferenceLikeElement = exports.isReferenceElement = exports.isPathsElement = exports.isPathItemElement = exports.isParametersDefinitionsElement = exports.isParameterElement = exports.isOperationElement = exports.isLicenseElement = exports.isJSONReferenceLikeElement = exports.isJSONReferenceElement = exports.isItemsElement = exports.isInfoElement = exports.isHeadersElement = exports.isHeaderElement = exports.isExternalDocumentationElement = exports.isExampleElement = exports.isDefinitionsElement = exports.isContactElement = exports.default = exports.XmlElement = exports.Visitor = exports.TagElement = exports.SwaggerVersionElement = exports.SwaggerTagsElement = exports.SwaggerSecurityElement = exports.SwaggerSchemesElement = exports.SwaggerProducesElement = exports.SwaggerElement = exports.SwaggerConsumesElement = exports.SpecificationVisitor = exports.SecuritySchemeElement = exports.SecurityRequirementElement = exports.SecurityDefinitionsElement = exports.ScopesElement = exports.SchemaElement = exports.ResponsesElement = exports.ResponsesDefinitionsElement = exports.ResponseElement = exports.ReferenceElement = exports.PatternedFieldsVisitor = exports.PathsElement = exports.PathItemParametersElement = exports.PathItemElement = exports.ParametersDefinitionsElement = exports.ParameterElement = exports.OperationTagsElement = exports.OperationSecurityElement = exports.OperationSchemesElement = exports.OperationProducesElement = exports.OperationParametersElement = exports.OperationElement = exports.OperationConsumesElement = exports.OpenAPIMediaTypes = exports.MixedFieldsVisitorBase = exports.MixedFieldsVisitor = exports.MapVisitor = exports.LicenseElement = exports.JSONReferenceElement = exports.ItemsElement = exports.InfoElement = exports.HeadersElement = exports.HeaderElement = exports.FixedFieldsVisitor = exports.FallbackVisitor = exports.ExternalDocumentationElement = exports.ExampleElement = exports.DefinitionsElement = exports.ContactElement = exports.BaseSpecificationVisitor = exports.BasePatternedFieldsVisitor = exports.BaseMixedFieldsVisitor = exports.BaseMapVisitor = exports.BaseFixedFieldsVisitor = exports.BaseAlternatingVisitor = exports.AlternatingVisitor = void 0;
-exports.specificationObj = exports.refractorPluginReplaceEmptyElement = exports.refractXml = exports.refractTag = exports.refractSwagger = exports.refractSecurityScheme = exports.refractSecurityRequirement = exports.refractSecurityDefinitions = exports.refractScopes = exports.refractSchema = exports.refractResponsesDefinitions = exports.refractResponses = exports.refractResponse = exports.refractReference = exports.refractPaths = exports.refractPathItem = exports.refractParametersDefinitions = exports.refractParameter = void 0;
+exports.refractLicense = exports.refractJSONReference = exports.refractItems = exports.refractInfo = exports.refractHeaders = exports.refractHeader = exports.refractExternalDocumentation = exports.refractExample = exports.refractDefinitions = exports.refractContact = exports.refract = exports.mediaTypes = exports.isXmlElement = exports.isTagElement = exports.isSwaggerVersionElement = exports.isSwaggerExtension = exports.isSwaggerElement = exports.isSecuritySchemeElement = exports.isSecurityRequirementElement = exports.isSecurityDefinitionsElement = exports.isScopesElement = exports.isSchemaElement = exports.isResponsesElement = exports.isResponsesDefinitionsElement = exports.isResponseElement = exports.isReferenceLikeElement = exports.isReferenceElement = exports.isPathsElement = exports.isPathItemElement = exports.isParametersDefinitionsElement = exports.isParameterElement = exports.isOperationElement = exports.isLicenseElement = exports.isJSONReferenceLikeElement = exports.isJSONReferenceElement = exports.isItemsElement = exports.isInfoElement = exports.isHeadersElement = exports.isHeaderElement = exports.isExternalDocumentationElement = exports.isExampleElement = exports.isDefinitionsElement = exports.isContactElement = exports.default = exports.XmlElement = exports.Visitor = exports.TagElement = exports.SwaggerVersionElement = exports.SwaggerTagsElement = exports.SwaggerSecurityElement = exports.SwaggerSchemesElement = exports.SwaggerProducesElement = exports.SwaggerElement = exports.SwaggerConsumesElement = exports.SpecificationVisitor = exports.SecuritySchemeElement = exports.SecurityRequirementElement = exports.SecurityDefinitionsElement = exports.ScopesElement = exports.SchemaElement = exports.ResponsesElement = exports.ResponsesDefinitionsElement = exports.ResponseElement = exports.ReferenceElement = exports.PatternedFieldsVisitor = exports.PathsElement = exports.PathItemParametersElement = exports.PathItemElement = exports.ParametersDefinitionsElement = exports.ParameterElement = exports.OperationTagsElement = exports.OperationSecurityElement = exports.OperationSchemesElement = exports.OperationProducesElement = exports.OperationParametersElement = exports.OperationElement = exports.OperationConsumesElement = exports.OpenAPIMediaTypes = exports.MixedFieldsVisitorBase = exports.MixedFieldsVisitor = exports.MapVisitor = exports.LicenseElement = exports.JSONReferenceElement = exports.ItemsElement = exports.InfoElement = exports.HeadersElement = exports.HeaderElement = exports.FixedFieldsVisitor = exports.FallbackVisitor = exports.ExternalDocumentationElement = exports.ExampleElement = exports.DefinitionsElement = exports.ContactElement = exports.BaseSpecificationVisitor = exports.BasePatternedFieldsVisitor = exports.BaseMixedFieldsVisitor = exports.BaseMapVisitor = exports.BaseFixedFieldsVisitor = exports.BaseAlternatingVisitor = exports.AlternatingVisitor = void 0;
+exports.specificationObj = exports.refractorPluginReplaceEmptyElement = exports.refractXml = exports.refractTag = exports.refractSwagger = exports.refractSecurityScheme = exports.refractSecurityRequirement = exports.refractSecurityDefinitions = exports.refractScopes = exports.refractSchema = exports.refractResponsesDefinitions = exports.refractResponses = exports.refractResponse = exports.refractReference = exports.refractPaths = exports.refractPathItem = exports.refractParametersDefinitions = exports.refractParameter = exports.refractOperation = void 0;
 var _apidomNsJsonSchemaDraft = require("@speclynx/apidom-ns-json-schema-draft-4");
 exports.isJSONReferenceElement = _apidomNsJsonSchemaDraft.isJSONReferenceElement;
 exports.isJSONReferenceLikeElement = _apidomNsJsonSchemaDraft.isJSONReferenceLikeElement;
 exports.JSONReferenceElement = _apidomNsJsonSchemaDraft.JSONReferenceElement;
+exports.refractJSONReference = _apidomNsJsonSchemaDraft.refractJSONReference;
 var _mediaTypes = _interopRequireWildcard(require("./media-types.cjs"));
 exports.mediaTypes = _mediaTypes.default;
 exports.OpenAPIMediaTypes = _mediaTypes.OpenAPIMediaTypes;

package/src/index.mjs

@@ -1,4 +1,4 @@
-export { isJSONReferenceElement, isJSONReferenceLikeElement, JSONReferenceElement } from '@speclynx/apidom-ns-json-schema-draft-4';
+export { isJSONReferenceElement, isJSONReferenceLikeElement, JSONReferenceElement, refractJSONReference } from '@speclynx/apidom-ns-json-schema-draft-4';
 export { default as mediaTypes, OpenAPIMediaTypes } from "./media-types.mjs";
 export { default } from "./namespace.mjs";
 export { default as refractorPluginReplaceEmptyElement } from "./refractor/plugins/replace-empty-element.mjs";

package/src/refractor/index.cjs

@@ -23,7 +23,8 @@ var _toolbox = _interopRequireDefault(require("./toolbox.cjs"));
 const refract = (value, {
   element = 'swagger',
   plugins = [],
-  specificationObj = _specification.default
+  specificationObj = _specification.default,
+  consume = false
 } = {}) => {
   const genericElement = (0, _apidomDatamodel.refract)(value);
   const resolvedSpec = (0, _apidomCore.resolveSpecification)(specificationObj);
@@ -40,7 +41,8 @@ const refract = (value, {
    */
   const RootVisitorClass = (0, _ramda.path)(specPath, resolvedSpec);
   const rootVisitor = new RootVisitorClass({
-    specObj: resolvedSpec
+    specObj: resolvedSpec,
+    consume
   });
   (0, _apidomTraverse.traverse)(genericElement, rootVisitor);
 

package/src/refractor/index.mjs

@@ -16,7 +16,8 @@ import createToolbox from "./toolbox.mjs";
 const refract = (value, {
   element = 'swagger',
   plugins = [],
-  specificationObj = specification
+  specificationObj = specification,
+  consume = false
 } = {}) => {
   const genericElement = baseRefract(value);
   const resolvedSpec = resolveSpecification(specificationObj);
@@ -33,7 +34,8 @@ const refract = (value, {
    */
   const RootVisitorClass = path(specPath, resolvedSpec);
   const rootVisitor = new RootVisitorClass({
-    specObj: resolvedSpec
+    specObj: resolvedSpec,
+    consume
   });
   traverse(genericElement, rootVisitor);
 

package/src/refractor/plugins/replace-empty-element.cjs

@@ -324,8 +324,9 @@ const schema = {
   }
 };
 const findElementFactory = (ancestor, keyName) => {
-  const elementType = (0, _apidomTraverse.getNodeType)(ancestor); // @ts-ignore
-  const keyMapping = schema[elementType] || schema[(0, _apidomCore.toValue)(ancestor.classes.first)];
+  const elementType = (0, _apidomTraverse.getNodeType)(ancestor);
+  const classType = ancestor.isMetaEmpty ? undefined : ancestor.classes.at(0); // @ts-ignore
+  const keyMapping = schema[elementType] || schema[classType];
   return typeof keyMapping === 'undefined' ? undefined : Object.hasOwn(keyMapping, '[key: *]') ? keyMapping['[key: *]'] : keyMapping[keyName];
 };
 
@@ -355,7 +356,7 @@ const plugin = () => () => ({
       if (typeof elementFactory !== 'function') return;
       const replacement = elementFactory.call({
         context
-      }, undefined, (0, _apidomDatamodel.cloneDeep)(element.meta), (0, _apidomDatamodel.cloneDeep)(element.attributes));
+      }, undefined, element.isMetaEmpty ? undefined : element.meta.cloneDeep(), element.isAttributesEmpty ? undefined : (0, _apidomDatamodel.cloneDeep)(element.attributes));
       _apidomDatamodel.SourceMapElement.transfer(element, replacement);
       _apidomDatamodel.StyleElement.transfer(element, replacement);
       path.replaceWith(replacement);

package/src/refractor/plugins/replace-empty-element.mjs

@@ -316,8 +316,9 @@ const schema = {
   }
 };
 const findElementFactory = (ancestor, keyName) => {
-  const elementType = getNodeType(ancestor); // @ts-ignore
-  const keyMapping = schema[elementType] || schema[toValue(ancestor.classes.first)];
+  const elementType = getNodeType(ancestor);
+  const classType = ancestor.isMetaEmpty ? undefined : ancestor.classes.at(0); // @ts-ignore
+  const keyMapping = schema[elementType] || schema[classType];
   return typeof keyMapping === 'undefined' ? undefined : Object.hasOwn(keyMapping, '[key: *]') ? keyMapping['[key: *]'] : keyMapping[keyName];
 };
 
@@ -347,7 +348,7 @@ const plugin = () => () => ({
       if (typeof elementFactory !== 'function') return;
       const replacement = elementFactory.call({
         context
-      }, undefined, cloneDeep(element.meta), cloneDeep(element.attributes));
+      }, undefined, element.isMetaEmpty ? undefined : element.meta.cloneDeep(), element.isAttributesEmpty ? undefined : cloneDeep(element.attributes));
       SourceMapElement.transfer(element, replacement);
       StyleElement.transfer(element, replacement);
       path.replaceWith(replacement);

package/src/refractor/visitors/FallbackVisitor.cjs

@@ -17,7 +17,7 @@ var _Visitor = _interopRequireDefault(require("./Visitor.cjs"));
  */
 class FallbackVisitor extends _Visitor.default {
   enter(path) {
-    this.element = (0, _apidomDatamodel.cloneDeep)(path.node);
+    this.element = this.consume ? path.node : (0, _apidomDatamodel.cloneDeep)(path.node);
     path.stop();
   }
 }

package/src/refractor/visitors/FallbackVisitor.mjs

@@ -11,7 +11,7 @@ import Visitor from "./Visitor.mjs";
  */
 class FallbackVisitor extends Visitor {
   enter(path) {
-    this.element = cloneDeep(path.node);
+    this.element = this.consume ? path.node : cloneDeep(path.node);
     path.stop();
   }
 }

package/src/refractor/visitors/SpecificationVisitor.cjs

@@ -20,7 +20,7 @@ var _FallbackVisitor = _interopRequireDefault(require("./FallbackVisitor.cjs"));
  */
 class SpecificationVisitor extends _Visitor.default {
   specObj;
-  passingOptionsNames = ['specObj'];
+  passingOptionsNames = ['specObj', 'consume'];
   constructor({
     specObj,
     ...rest
@@ -66,7 +66,7 @@ class SpecificationVisitor extends _Visitor.default {
      */
     const visitor = this.retrieveVisitorInstance(specPath, options);
     if (visitor instanceof _FallbackVisitor.default && visitor?.constructor === _FallbackVisitor.default) {
-      return (0, _apidomDatamodel.cloneDeep)(element);
+      return this.consume ? element : (0, _apidomDatamodel.cloneDeep)(element);
     }
     (0, _apidomTraverse.traverse)(element, visitor);
     return visitor.element;

package/src/refractor/visitors/SpecificationVisitor.mjs

@@ -14,7 +14,7 @@ import FallbackVisitor from "./FallbackVisitor.mjs";
  */
 class SpecificationVisitor extends Visitor {
   specObj;
-  passingOptionsNames = ['specObj'];
+  passingOptionsNames = ['specObj', 'consume'];
   constructor({
     specObj,
     ...rest
@@ -60,7 +60,7 @@ class SpecificationVisitor extends Visitor {
      */
     const visitor = this.retrieveVisitorInstance(specPath, options);
     if (visitor instanceof FallbackVisitor && visitor?.constructor === FallbackVisitor) {
-      return cloneDeep(element);
+      return this.consume ? element : cloneDeep(element);
     }
     traverse(element, visitor);
     return visitor.element;

package/src/refractor/visitors/Visitor.cjs

@@ -13,19 +13,21 @@ var _apidomDatamodel = require("@speclynx/apidom-datamodel");
  */
 class Visitor {
   element;
+  consume = false;
+  consumeSafe = false;
   constructor(options = {}) {
     Object.assign(this, options);
   }
   copyMetaAndAttributes(from, to) {
-    if (!from.isMetaEmpty || !to.isMetaEmpty) {
-      const target = to.isMetaEmpty ? new _apidomDatamodel.ObjectElement() : to.meta;
-      const source = from.isMetaEmpty ? new _apidomDatamodel.ObjectElement() : from.meta;
-      to.meta = (0, _apidomCore.deepmerge)(target, source);
+    if (!from.isMetaEmpty && !to.isMetaEmpty) {
+      to.meta = to.meta.merge(from.meta);
+    } else if (!from.isMetaEmpty) {
+      to.meta = from.meta.cloneDeep();
     }
-    if (!from.isAttributesEmpty || !to.isAttributesEmpty) {
-      const target = to.isAttributesEmpty ? new _apidomDatamodel.ObjectElement() : to.attributes;
-      const source = from.isAttributesEmpty ? new _apidomDatamodel.ObjectElement() : from.attributes;
-      to.attributes = (0, _apidomCore.deepmerge)(target, source);
+    if (!from.isAttributesEmpty && !to.isAttributesEmpty) {
+      to.attributes = (0, _apidomCore.deepmerge)(to.attributes, from.attributes);
+    } else if (!from.isAttributesEmpty) {
+      to.attributes = (0, _apidomDatamodel.cloneDeep)(from.attributes);
     }
     _apidomDatamodel.SourceMapElement.transfer(from, to);
     _apidomDatamodel.StyleElement.transfer(from, to);

package/src/refractor/visitors/Visitor.mjs

@@ -1,5 +1,5 @@
 import { deepmerge } from '@speclynx/apidom-core';
-import { ObjectElement, SourceMapElement, StyleElement } from '@speclynx/apidom-datamodel';
+import { SourceMapElement, StyleElement, cloneDeep } from '@speclynx/apidom-datamodel';
 
 /**
  * @public
@@ -10,19 +10,21 @@ import { ObjectElement, SourceMapElement, StyleElement } from '@speclynx/apidom-
  */
 class Visitor {
   element;
+  consume = false;
+  consumeSafe = false;
   constructor(options = {}) {
     Object.assign(this, options);
   }
   copyMetaAndAttributes(from, to) {
-    if (!from.isMetaEmpty || !to.isMetaEmpty) {
-      const target = to.isMetaEmpty ? new ObjectElement() : to.meta;
-      const source = from.isMetaEmpty ? new ObjectElement() : from.meta;
-      to.meta = deepmerge(target, source);
+    if (!from.isMetaEmpty && !to.isMetaEmpty) {
+      to.meta = to.meta.merge(from.meta);
+    } else if (!from.isMetaEmpty) {
+      to.meta = from.meta.cloneDeep();
     }
-    if (!from.isAttributesEmpty || !to.isAttributesEmpty) {
-      const target = to.isAttributesEmpty ? new ObjectElement() : to.attributes;
-      const source = from.isAttributesEmpty ? new ObjectElement() : from.attributes;
-      to.attributes = deepmerge(target, source);
+    if (!from.isAttributesEmpty && !to.isAttributesEmpty) {
+      to.attributes = deepmerge(to.attributes, from.attributes);
+    } else if (!from.isAttributesEmpty) {
+      to.attributes = cloneDeep(from.attributes);
     }
     SourceMapElement.transfer(from, to);
     StyleElement.transfer(from, to);

package/src/refractor/visitors/generics/FixedFieldsVisitor.cjs

@@ -52,15 +52,18 @@ class FixedFieldsVisitor extends _SpecificationVisitor.default {
       const keyValue = (0, _apidomCore.toValue)(key);
       if ((0, _apidomDatamodel.isStringElement)(key) && fields.includes(keyValue) && !this.ignoredFields.includes(keyValue)) {
         const fixedFieldElement = this.toRefractedElement([...specPath, 'fixedFields', keyValue], value);
-        const newMemberElement = new _apidomDatamodel.MemberElement((0, _apidomDatamodel.cloneDeep)(key), fixedFieldElement);
+        const newMemberElement = new _apidomDatamodel.MemberElement(this.consume ? key : (0, _apidomDatamodel.cloneDeep)(key), fixedFieldElement);
         this.copyMetaAndAttributes(memberElement, newMemberElement);
-        newMemberElement.classes.push('fixed-field');
         this.element.content.push(newMemberElement);
+        // consume: release processed generic subtree
+        if (this.consume && this.consumeSafe && !memberElement.isFrozen) memberElement.value = undefined;
       } else if (this.canSupportSpecificationExtensions && this.specificationExtensionPredicate(memberElement)) {
         const extensionElement = this.toRefractedElement(['document', 'extension'], memberElement);
         this.element.content.push(extensionElement);
+        // consume: release processed generic subtree
+        if (this.consume && this.consumeSafe && !memberElement.isFrozen) memberElement.value = undefined;
       } else if (!this.ignoredFields.includes(keyValue)) {
-        this.element.content.push((0, _apidomDatamodel.cloneDeep)(memberElement));
+        this.element.content.push(this.consume ? memberElement : (0, _apidomDatamodel.cloneDeep)(memberElement));
       }
     });
     this.copyMetaAndAttributes(objectElement, this.element);

package/src/refractor/visitors/generics/FixedFieldsVisitor.mjs

@@ -45,15 +45,18 @@ class FixedFieldsVisitor extends SpecificationVisitor {
       const keyValue = toValue(key);
       if (isStringElement(key) && fields.includes(keyValue) && !this.ignoredFields.includes(keyValue)) {
         const fixedFieldElement = this.toRefractedElement([...specPath, 'fixedFields', keyValue], value);
-        const newMemberElement = new MemberElement(cloneDeep(key), fixedFieldElement);
+        const newMemberElement = new MemberElement(this.consume ? key : cloneDeep(key), fixedFieldElement);
         this.copyMetaAndAttributes(memberElement, newMemberElement);
-        newMemberElement.classes.push('fixed-field');
         this.element.content.push(newMemberElement);
+        // consume: release processed generic subtree
+        if (this.consume && this.consumeSafe && !memberElement.isFrozen) memberElement.value = undefined;
       } else if (this.canSupportSpecificationExtensions && this.specificationExtensionPredicate(memberElement)) {
         const extensionElement = this.toRefractedElement(['document', 'extension'], memberElement);
         this.element.content.push(extensionElement);
+        // consume: release processed generic subtree
+        if (this.consume && this.consumeSafe && !memberElement.isFrozen) memberElement.value = undefined;
       } else if (!this.ignoredFields.includes(keyValue)) {
-        this.element.content.push(cloneDeep(memberElement));
+        this.element.content.push(this.consume ? memberElement : cloneDeep(memberElement));
       }
     });
     this.copyMetaAndAttributes(objectElement, this.element);

package/src/refractor/visitors/generics/PatternedFieldsVisitor.cjs

@@ -55,12 +55,14 @@ class PatternedFieldsVisitor extends _SpecificationVisitor.default {
       } else if (!this.ignoredFields.includes(keyValue) && this.fieldPatternPredicate(keyValue)) {
         const specPath = this.specPath(value);
         const patternedFieldElement = this.toRefractedElement(specPath, value);
-        const newMemberElement = new _apidomDatamodel.MemberElement((0, _apidomDatamodel.cloneDeep)(key), patternedFieldElement);
+        const newMemberElement = new _apidomDatamodel.MemberElement(this.consume ? key : (0, _apidomDatamodel.cloneDeep)(key), patternedFieldElement);
         this.copyMetaAndAttributes(memberElement, newMemberElement);
         newMemberElement.classes.push('patterned-field');
         this.element.content.push(newMemberElement);
+        // consume: release processed generic subtree
+        if (this.consume && this.consumeSafe && !memberElement.isFrozen) memberElement.value = undefined;
       } else if (!this.ignoredFields.includes(keyValue)) {
-        this.element.content.push((0, _apidomDatamodel.cloneDeep)(memberElement));
+        this.element.content.push(this.consume ? memberElement : (0, _apidomDatamodel.cloneDeep)(memberElement));
       }
     });
     this.copyMetaAndAttributes(objectElement, this.element);

package/src/refractor/visitors/generics/PatternedFieldsVisitor.mjs

@@ -49,12 +49,14 @@ class PatternedFieldsVisitor extends SpecificationVisitor {
       } else if (!this.ignoredFields.includes(keyValue) && this.fieldPatternPredicate(keyValue)) {
         const specPath = this.specPath(value);
         const patternedFieldElement = this.toRefractedElement(specPath, value);
-        const newMemberElement = new MemberElement(cloneDeep(key), patternedFieldElement);
+        const newMemberElement = new MemberElement(this.consume ? key : cloneDeep(key), patternedFieldElement);
         this.copyMetaAndAttributes(memberElement, newMemberElement);
         newMemberElement.classes.push('patterned-field');
         this.element.content.push(newMemberElement);
+        // consume: release processed generic subtree
+        if (this.consume && this.consumeSafe && !memberElement.isFrozen) memberElement.value = undefined;
       } else if (!this.ignoredFields.includes(keyValue)) {
-        this.element.content.push(cloneDeep(memberElement));
+        this.element.content.push(this.consume ? memberElement : cloneDeep(memberElement));
       }
     });
     this.copyMetaAndAttributes(objectElement, this.element);

package/src/refractor/visitors/open-api-2/index.cjs

@@ -13,6 +13,7 @@ class SwaggerVisitor extends _bases.BaseFixedFieldsVisitor {
   constructor(options) {
     super(options);
     this.element = new _Swagger.default();
+    this.consumeSafe = true;
     this.specPath = (0, _ramda.always)(['document', 'objects', 'Swagger']);
     this.canSupportSpecificationExtensions = true;
   }

package/src/refractor/visitors/open-api-2/index.mjs

@@ -8,6 +8,7 @@ class SwaggerVisitor extends BaseFixedFieldsVisitor {
   constructor(options) {
     super(options);
     this.element = new SwaggerElement();
+    this.consumeSafe = true;
     this.specPath = always(['document', 'objects', 'Swagger']);
     this.canSupportSpecificationExtensions = true;
   }

package/src/refractor/visitors/open-api-2/path-item/index.cjs

@@ -16,6 +16,7 @@ class PathItemVisitor extends _bases.BaseFixedFieldsVisitor {
   constructor(options) {
     super(options);
     this.element = new _PathItem.default();
+    this.consumeSafe = true;
     this.specPath = (0, _ramda.always)(['document', 'objects', 'PathItem']);
   }
   ObjectElement(path) {

package/src/refractor/visitors/open-api-2/path-item/index.mjs

@@ -11,6 +11,7 @@ class PathItemVisitor extends BaseFixedFieldsVisitor {
   constructor(options) {
     super(options);
     this.element = new PathItemElement();
+    this.consumeSafe = true;
     this.specPath = always(['document', 'objects', 'PathItem']);
   }
   ObjectElement(path) {

package/src/refractor/visitors/open-api-2/paths/index.cjs

@@ -16,6 +16,7 @@ class PathsVisitor extends _bases.BasePatternedFieldsVisitor {
   constructor(options) {
     super(options);
     this.element = new _Paths.default();
+    this.consumeSafe = true;
     this.specPath = (0, _ramda.always)(['document', 'objects', 'PathItem']);
     this.canSupportSpecificationExtensions = true;
     this.fieldPatternPredicate = _ramda.T;

package/src/refractor/visitors/open-api-2/paths/index.mjs

@@ -11,6 +11,7 @@ class PathsVisitor extends BasePatternedFieldsVisitor {
   constructor(options) {
     super(options);
     this.element = new PathsElement();
+    this.consumeSafe = true;
     this.specPath = always(['document', 'objects', 'PathItem']);
     this.canSupportSpecificationExtensions = true;
     this.fieldPatternPredicate = stubTrue;

package/types/apidom-ns-openapi-2.d.ts

@@ -23,6 +23,7 @@ import { NumberElement } from '@speclynx/apidom-datamodel';
 import { ObjectElement } from '@speclynx/apidom-datamodel';
 import { Path } from '@speclynx/apidom-traverse';
 import { PropertiesVisitor } from '@speclynx/apidom-ns-json-schema-draft-4';
+import { refractJSONReference } from '@speclynx/apidom-ns-json-schema-draft-4';
 import { RequiredVisitor } from '@speclynx/apidom-ns-json-schema-draft-4';
 import { AllOfVisitorOptions as SchemaAllOfVisitorOptions } from '@speclynx/apidom-ns-json-schema-draft-4';
 import { ItemsVisitorOptions as SchemaItemsVisitorOptions } from '@speclynx/apidom-ns-json-schema-draft-4';
@@ -1186,7 +1187,7 @@ export declare class ReferenceVisitor extends BaseFixedFieldsVisitor {
 /**
  * @public
  */
-export declare const refract: <T extends Element_2>(value: unknown, { element, plugins, specificationObj }?: RefractorOptions) => T;
+export declare const refract: <T extends Element_2>(value: unknown, { element, plugins, specificationObj, consume, }?: RefractorOptions) => T;
 
 /**
  * Refracts a value into a ContactElement.
@@ -1236,6 +1237,8 @@ export declare const refractInfo: <T extends Element_2 = InfoElement>(value: unk
  */
 export declare const refractItems: <T extends Element_2 = ItemsElement>(value: unknown, options?: Omit<RefractorOptions, "element">) => T;
 
+export { refractJSONReference }
+
 /**
  * Refracts a value into a LicenseElement.
  * @public
@@ -1255,6 +1258,7 @@ export declare interface RefractorOptions {
     readonly element?: string;
     readonly plugins?: RefractorPlugin[];
     readonly specificationObj?: typeof specificationObj;
+    readonly consume?: boolean;
 }
 
 /**
@@ -2239,7 +2243,7 @@ export declare class SpecificationVisitor extends Visitor {
     protected readonly specObj: typeof specificationObj;
     protected readonly passingOptionsNames: string[];
     constructor({ specObj, ...rest }: SpecificationVisitorOptions);
-    retrievePassingOptions(): Pick<this, keyof this>;
+    retrievePassingOptions(): Record<string, unknown>;
     retrieveFixedFields(specPath: string[]): string[];
     retrieveVisitor(specPath: string[]): unknown;
     retrieveVisitorInstance(specPath: string[], options?: {}): Visitor;
@@ -2407,6 +2411,8 @@ export declare interface Toolbox {
  */
 export declare class Visitor {
     element: Element_2;
+    protected readonly consume: boolean;
+    protected consumeSafe: boolean;
     constructor(options?: VisitorOptions);
     copyMetaAndAttributes(from: Element_2, to: Element_2): void;
 }
@@ -2415,6 +2421,7 @@ export declare class Visitor {
  * @public
  */
 declare interface VisitorOptions {
+    readonly consume?: boolean;
 }
 export { VisitorOptions as BasePathVisitorOptions }
 export { VisitorOptions as ConsumesVisitorOptions }