feat(core):added extract decorator method

packages/concerto-core/api.txt

@@ -57,6 +57,7 @@ class Concerto {
 class DecoratorManager {
    + ModelManager validate(decoratorCommandSet,ModelFile[]) throws Error
    + ModelManager decorateModels(ModelManager,decoratorCommandSet,object?,boolean?,boolean?,boolean?) 
+   + ExtractDecoratorsResult extractDecorators(ModelManager,object,boolean,string) 
    + void validateCommand(ModelManager,command) 
    + Boolean falsyOrEqual(string||,string[]) 
    + void applyDecorator(decorated,string,newDecorator) 

packages/concerto-core/changelog.txt

@@ -24,6 +24,9 @@
 # Note that the latest public API is documented using JSDocs and is available in api.txt.
 #
 
+Version 3.14.2 {c8e20253a3695fcaed97472d697e282d} 2023-11-07
+- Added DCS and vocabulary extraction support for decoratorManager
+
 Version 3.13.1 {f5a9a1ea6a64865843a3abb77798cbb0} 2023-10-18
 - Add migrate option to DecoratorManager options
 

packages/concerto-core/lib/decoratormanager.js

@@ -20,6 +20,7 @@ const Factory = require('./factory');
 const ModelUtil = require('./modelutil');
 const { MetaModelNamespace } = require('@accordproject/concerto-metamodel');
 const semver = require('semver');
+const DecoratorUtil = require('./decoratorutil');
 
 // Types needed for TypeScript generation.
 /* eslint-disable no-unused-vars */
@@ -147,7 +148,7 @@ class DecoratorManager {
             metamodelValidation: true,
             addMetamodel: true,
         });
-        if(modelFiles) {
+        if (modelFiles) {
             validationModelManager.addModelFiles(modelFiles);
         }
         validationModelManager.addCTOModel(
@@ -252,6 +253,38 @@ class DecoratorManager {
         newModelManager.fromAst(decoratedAst);
         return newModelManager;
     }
+    /**
+     * @typedef decoratorCommandSet
+     * @type {object}
+     * @typedef vocabularies
+     * @type {string}
+     * @typedef ExtractDecoratorsResult
+     * @type {object}
+     * @property {ModelManager} modelManager - A model manager containing models stripped without decorators
+     * @property {decoratorCommandSet} object[] - Stripped out decorators, formed into decorator command sets
+     * @property {vocabularies} object[] - Stripped out vocabularies, formed into vocabulary files
+    */
+    /**
+     * Extracts all the decorator commands from all the models in modelManager
+     * @param {ModelManager} modelManager the input model manager
+     * @param {object} options - decorator models options
+     * @param {boolean} options.removeDecoratorsFromModel - flag to strip out decorators from models
+     * @param {string} options.locale - locale for extracted vocabulary set
+     * @returns {ExtractDecoratorsResult} - a new model manager with the decorations removed and a list of extracted decorator jsons and vocab yamls
+     */
+    static extractDecorators(modelManager,options) {
+        options = {
+            removeDecoratorsFromModel: false,
+            locale:'en',
+            ...options
+        };
+        const collectionResp = DecoratorUtil.collectExtractedDecoratorsAndProcessedModels(modelManager, options.removeDecoratorsFromModel, options.locale, DCS_VERSION);
+        return {
+            modelManager: collectionResp.updatedModelManager,
+            decoratorCommandSet: collectionResp.decoratorCommandSet,
+            vocabularies: collectionResp.vocabularies
+        };
+    }
 
     /**
      * Throws an error if the decoractor command is invalid
@@ -421,7 +454,7 @@ class DecoratorManager {
 
             if (declaration.$class === `${MetaModelNamespace}.MapDeclaration`) {
                 if (target.mapElement) {
-                    switch(target.mapElement) {
+                    switch (target.mapElement) {
                     case 'KEY':
                     case 'VALUE':
                         this.applyDecoratorForMapElement(target.mapElement, target, declaration, type, decorator);
@@ -476,4 +509,4 @@ class DecoratorManager {
     }
 }
 
-module.exports = DecoratorManager;
+module.exports = DecoratorManager;