sol2uml 2.1.1 → 2.1.4

package/README.md

@@ -44,22 +44,22 @@ npm ls sol2uml -g
 ## Command Line Interface (CLI)
 
 ```
-$ sol2uml --help
 Usage: sol2uml [subcommand] <options>
 The three subcommands:
 * class:    Generates a UML class diagram from Solidity source code. default
 * storage:  Generates a diagram of a contract's storage slots.
-* flatten:  Pulls verified source files from a Blockchain explorer into one, flat, local Solidity file.
+* flatten:  Merges verified source files from a Blockchain explorer into one local file.
 
 The Solidity code can be pulled from verified source code on Blockchain explorers like Etherscan or from local Solidity files.
 
 Options:
+  -V, --version                                output the version number
   -sf, --subfolders <value>                    number of subfolders that will be recursively searched for Solidity files. (default: all)
   -f, --outputFormat <value>                   output file format. (choices: "svg", "png", "dot", "all", default: "svg")
   -o, --outputFileName <value>                 output file name
   -i, --ignoreFilesOrFolders <filesOrFolders>  comma separated list of files or folders to ignore
-  -n, --network <network>                      Ethereum network (choices: "mainnet", "polygon", "bsc", "arbitrum", "ropsten", "kovan", "rinkeby", "goerli", "sepolia", default: "mainnet")
-  -k, --apiKey <key>                           Etherscan, Polygonscan or BscScan API key
+  -n, --network <network>                      Ethereum network (choices: "mainnet", "ropsten", "kovan", "rinkeby", "goerli", "sepolia", "polygon", "testnet.polygon", "arbitrum", "testnet.arbitrum", "avalanche", "testnet.avalanche", "bsc", "testnet.bsc", "crono", "fantom", "testnet.fantom", "moonbeam", "optimistic", "kovan-optimistic", default: "mainnet", env: ETH_NETWORK)
+  -k, --apiKey <key>                           Blockchain explorer API key. eg Etherscan, Arbiscan, BscScan, CronoScan, FTMScan, PolygonScan or SnowTrace API key (env: SCAN_API_KEY)
   -v, --verbose                                run with debugging statements (default: false)
   -h, --help                                   display help for command
 
@@ -73,7 +73,6 @@ Commands:
 ### Class usage
 
 ```
-$sol2uml class --help
 Usage: sol2uml class <fileFolderAddress> [options]
 
 Generates UML diagrams from Solidity source code.
@@ -110,20 +109,19 @@ Options:
 ### Storage usage
 
 ```
-Usage: sol2uml storage [options] <fileFolderAddress>
-
-Visually display a contract's storage slots.
+Usage: sol2uml storage <fileFolderAddress> [options]
 
 WARNING: sol2uml does not use the Solidity compiler so may differ with solc. A known example is fixed-sized arrays declared with an expression will fail to be sized.
 
+Visually display a contract's storage slots.
+
 Arguments:
   fileFolderAddress        file name, base folder or contract address
 
 Options:
   -c, --contract <name>    Contract name in local Solidity files. Not needed when using an address as the first argument as the contract name can be derived from Etherscan.
   -d, --data               Gets the values in the storage slots from an Ethereum node. (default: false)
-  -s, --storage <address>  The address of the contract with the storage values. This will be different from the contract with the code if a proxy contract is used. This is not needed if `fileFolderAddress` is an address and
-                           the contract is not proxied.
+  -s, --storage <address>  The address of the contract with the storage values. This will be different from the contract with the code if a proxy contract is used. This is not needed if `fileFolderAddress` is an address and the contract is not proxied.
   -u, --url <url>          URL of the Ethereum node to get storage values if the `data` option is used. (default: "http://localhost:8545", env: NODE_URL)
   -bn, --block <number>    Block number to get the contract storage values from. (default: "latest")
   -h, --help               display help for command
@@ -132,17 +130,20 @@ Options:
 ### Flatten usage
 
 ```
-$sol2uml flatten --help
-Usage: sol2uml flatten [options] <contractAddress>
+Usage: sol2uml flatten <contractAddress> [options]
+
+In order for the merged code to compile, the following is done:
+1. File imports are commented out.
+2. "SPDX-License-Identifier" is renamed to "SPDX--License-Identifier".
+3. Contract dependencies are analysed so the files are merged in an order that will compile.
 
-get all verified source code for a contract from the Blockchain explorer into one local file
+Merges verified source files for a contract from a Blockchain explorer into one local file.
 
 Arguments:
-  contractAddress  Contract address
+  contractAddress  Contract address in hexadecimal format with a 0x prefix.
 
 Options:
   -h, --help       display help for command
-
 ```
 
 ## UML Class diagram examples

package/lib/converterClasses2Storage.js

@@ -162,11 +162,10 @@ const parseReferenceStorage = (attribute, umlClass, otherClasses, storages) => {
             attributeType: baseAttributeType,
         };
         const { size: arrayItemSize } = (0, exports.calcStorageByteSize)(baseAttribute, umlClass, otherClasses);
-        const slotSize = arrayItemSize > 16 ? 32 : arrayItemSize;
         const firstVariable = {
             id: variableId++,
             fromSlot: 0,
-            toSlot: Math.floor((slotSize - 1) / 32),
+            toSlot: Math.floor((arrayItemSize - 1) / 32),
             byteSize: arrayItemSize,
             byteOffset: 0,
             type: baseType,
@@ -178,10 +177,10 @@ const parseReferenceStorage = (attribute, umlClass, otherClasses, storages) => {
             for (let i = 1; i < arrayLength; i++) {
                 variables.push({
                     id: variableId++,
-                    fromSlot: Math.floor((i * slotSize) / 32),
-                    toSlot: Math.floor(((i + 1) * slotSize - 1) / 32),
+                    fromSlot: Math.floor((i * arrayItemSize) / 32),
+                    toSlot: Math.floor(((i + 1) * arrayItemSize - 1) / 32),
                     byteSize: arrayItemSize,
-                    byteOffset: (i * slotSize) % 32,
+                    byteOffset: (i * arrayItemSize) % 32,
                     type: baseType,
                     dynamic,
                     noValue: false,

package/lib/filterClasses.d.ts

@@ -1,6 +1,7 @@
 import { WeightedDiGraph } from 'js-graph-algorithms';
 import { UmlClass } from './umlClass';
 export declare const classesConnectedToBaseContracts: (umlClasses: UmlClass[], baseContractNames: string[], depth?: number) => UmlClass[];
-export declare const classesConnectedToBaseContract: (umlClasses: UmlClass[], baseContractName: string, graph: WeightedDiGraph, depth?: number) => {
+export declare const classesConnectedToBaseContract: (umlClasses: UmlClass[], baseContractName: string, weightedDirectedGraph: WeightedDiGraph, depth?: number) => {
     [contractName: string]: UmlClass;
 };
+export declare const topologicalSortClasses: (umlClasses: UmlClass[]) => UmlClass[];

package/lib/filterClasses.js

@@ -1,21 +1,21 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.classesConnectedToBaseContract = exports.classesConnectedToBaseContracts = void 0;
+exports.topologicalSortClasses = exports.classesConnectedToBaseContract = exports.classesConnectedToBaseContracts = void 0;
 const js_graph_algorithms_1 = require("js-graph-algorithms");
 const associations_1 = require("./associations");
 const classesConnectedToBaseContracts = (umlClasses, baseContractNames, depth) => {
     let filteredUmlClasses = {};
-    const graph = loadGraph(umlClasses);
+    const weightedDirectedGraph = loadWeightedDirectedGraph(umlClasses);
     for (const baseContractName of baseContractNames) {
         filteredUmlClasses = {
             ...filteredUmlClasses,
-            ...(0, exports.classesConnectedToBaseContract)(umlClasses, baseContractName, graph, depth),
+            ...(0, exports.classesConnectedToBaseContract)(umlClasses, baseContractName, weightedDirectedGraph, depth),
         };
     }
     return Object.values(filteredUmlClasses);
 };
 exports.classesConnectedToBaseContracts = classesConnectedToBaseContracts;
-const classesConnectedToBaseContract = (umlClasses, baseContractName, graph, depth = 1000) => {
+const classesConnectedToBaseContract = (umlClasses, baseContractName, weightedDirectedGraph, depth = 1000) => {
     // Find the base UML Class from the base contract name
     const baseUmlClass = umlClasses.find(({ name }) => {
         return name === baseContractName;
@@ -23,7 +23,7 @@ const classesConnectedToBaseContract = (umlClasses, baseContractName, graph, dep
     if (!baseUmlClass) {
         throw Error(`Failed to find base contract with name "${baseContractName}"`);
     }
-    const dfs = new js_graph_algorithms_1.Dijkstra(graph, baseUmlClass.id);
+    const dfs = new js_graph_algorithms_1.Dijkstra(weightedDirectedGraph, baseUmlClass.id);
     // Get all the UML Classes that are connected to the base contract
     const filteredUmlClasses = {};
     for (const umlClass of umlClasses) {
@@ -34,8 +34,8 @@ const classesConnectedToBaseContract = (umlClasses, baseContractName, graph, dep
     return filteredUmlClasses;
 };
 exports.classesConnectedToBaseContract = classesConnectedToBaseContract;
-function loadGraph(umlClasses) {
-    const graph = new js_graph_algorithms_1.WeightedDiGraph(umlClasses.length); // 6 is the number vertices in the graph
+function loadWeightedDirectedGraph(umlClasses) {
+    const weightedDirectedGraph = new js_graph_algorithms_1.WeightedDiGraph(umlClasses.length); // the number vertices in the graph
     for (const sourceUmlClass of umlClasses) {
         for (const association of Object.values(sourceUmlClass.associations)) {
             // Find the first UML Class that matches the target class name
@@ -43,9 +43,34 @@ function loadGraph(umlClasses) {
             if (!targetUmlClass) {
                 continue;
             }
-            graph.addEdge(new js_graph_algorithms_1.Edge(sourceUmlClass.id, targetUmlClass.id, 1));
+            weightedDirectedGraph.addEdge(new js_graph_algorithms_1.Edge(sourceUmlClass.id, targetUmlClass.id, 1));
         }
     }
-    return graph;
+    return weightedDirectedGraph;
 }
+const topologicalSortClasses = (umlClasses) => {
+    const directedAcyclicGraph = loadDirectedAcyclicGraph(umlClasses);
+    const topologicalSort = new js_graph_algorithms_1.TopologicalSort(directedAcyclicGraph);
+    // Topological sort the class ids
+    const sortedUmlClassIds = topologicalSort.order().reverse();
+    const sortedUmlClasses = sortedUmlClassIds.map((umlClassId) => 
+    // Lookup the UmlClass for each class id
+    umlClasses.find((umlClass) => umlClass.id === umlClassId));
+    return sortedUmlClasses;
+};
+exports.topologicalSortClasses = topologicalSortClasses;
+const loadDirectedAcyclicGraph = (umlClasses) => {
+    const directedAcyclicGraph = new js_graph_algorithms_1.DiGraph(umlClasses.length); // the number vertices in the graph
+    for (const sourceUmlClass of umlClasses) {
+        for (const association of Object.values(sourceUmlClass.associations)) {
+            // Find the first UML Class that matches the target class name
+            const targetUmlClass = (0, associations_1.findAssociatedClass)(association, sourceUmlClass, umlClasses);
+            if (!targetUmlClass) {
+                continue;
+            }
+            directedAcyclicGraph.addEdge(sourceUmlClass.id, targetUmlClass.id);
+        }
+    }
+    return directedAcyclicGraph;
+};
 //# sourceMappingURL=filterClasses.js.map

package/lib/parserEtherscan.d.ts

@@ -1,6 +1,6 @@
 import { ASTNode } from '@solidity-parser/parser/dist/src/ast-types';
 import { UmlClass } from './umlClass';
-declare const networks: readonly ["mainnet", "ropsten", "kovan", "rinkeby", "goerli", "sepolia", "polygon", "bsc", "arbitrum"];
+export declare const networks: readonly ["mainnet", "ropsten", "kovan", "rinkeby", "goerli", "sepolia", "polygon", "testnet.polygon", "arbitrum", "testnet.arbitrum", "avalanche", "testnet.avalanche", "bsc", "testnet.bsc", "crono", "fantom", "testnet.fantom", "moonbeam", "optimistic", "kovan-optimistic"];
 declare type Network = typeof networks[number];
 export declare class EtherscanParser {
     protected apikey: string;

package/lib/parserEtherscan.js

@@ -3,11 +3,13 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.EtherscanParser = void 0;
+exports.EtherscanParser = exports.networks = void 0;
 const axios_1 = __importDefault(require("axios"));
 const parser_1 = require("@solidity-parser/parser");
 const converterAST2Classes_1 = require("./converterAST2Classes");
-const networks = [
+const filterClasses_1 = require("./filterClasses");
+const debug = require('debug')('sol2uml');
+exports.networks = [
     'mainnet',
     'ropsten',
     'kovan',
@@ -15,15 +17,26 @@ const networks = [
     'goerli',
     'sepolia',
     'polygon',
-    'bsc',
+    'testnet.polygon',
     'arbitrum',
+    'testnet.arbitrum',
+    'avalanche',
+    'testnet.avalanche',
+    'bsc',
+    'testnet.bsc',
+    'crono',
+    'fantom',
+    'testnet.fantom',
+    'moonbeam',
+    'optimistic',
+    'kovan-optimistic',
 ];
 class EtherscanParser {
     constructor(apikey = 'ZAD4UI2RCXCQTP38EXS3UY2MPHFU5H9KB1', network = 'mainnet') {
         this.apikey = apikey;
         this.network = network;
-        if (!networks.includes(network)) {
-            throw new Error(`Invalid network "${network}". Must be one of ${networks}`);
+        if (!exports.networks.includes(network)) {
+            throw new Error(`Invalid network "${network}". Must be one of ${exports.networks}`);
         }
         else if (network === 'mainnet') {
             this.url = 'https://api.etherscan.io/api';
@@ -32,12 +45,52 @@ class EtherscanParser {
             this.url = 'https://api.polygonscan.com/api';
             this.apikey = 'AMHGNTV5A7XYGX2M781JB3RC1DZFVRWQEB';
         }
+        else if (network === 'testnet.polygon') {
+            this.url = 'https://api-testnet.polygonscan.com/api';
+            this.apikey = 'AMHGNTV5A7XYGX2M781JB3RC1DZFVRWQEB';
+        }
+        else if (network === 'arbitrum') {
+            this.url = 'https://api.arbiscan.io/api';
+            this.apikey = 'ZGTK2TAGWMAB6IAC12BMK8YYPNCPIM8VDQ';
+        }
+        else if (network === 'testnet.arbitrum') {
+            this.url = 'https://api-testnet.arbiscan.io/api';
+            this.apikey = 'ZGTK2TAGWMAB6IAC12BMK8YYPNCPIM8VDQ';
+        }
+        else if (network === 'avalanche') {
+            this.url = 'https://api.snowtrace.io/api';
+            this.apikey = 'U5FAN98S5XNH5VI83TI4H35R9I4TDCKEJY';
+        }
+        else if (network === 'testnet.avalanche') {
+            this.url = 'https://api-testnet.snowtrace.io/api';
+            this.apikey = 'U5FAN98S5XNH5VI83TI4H35R9I4TDCKEJY';
+        }
         else if (network === 'bsc') {
             this.url = 'https://api.bscscan.com/api';
+        }
+        else if (network === 'testnet.bsc') {
+            this.url = 'https://api-testnet.bscscan.com/api';
+        }
+        else if (network === 'crono') {
+            this.url = 'https://api.cronoscan.com/api';
+            this.apikey = '76A3RG5WHTPMMR66E9SFI2EIDT6MP976W2';
             this.apikey = 'APYH49FXVY9UA3KTDI6F4WP3KPIC86NITN';
         }
-        else if (network === 'arbitrum') {
-            this.url = 'https://api.arbiscan.io/api';
+        else if (network === 'fantom') {
+            this.url = 'https://api.ftmscan.com/api';
+            this.apikey = '71KRX13XPZMGR3D1Q85W78G2DSZ4JPMAEX';
+        }
+        else if (network === 'testnet.fantom') {
+            this.url = 'https://api-testnet.ftmscan.com/api';
+            this.apikey = '71KRX13XPZMGR3D1Q85W78G2DSZ4JPMAEX';
+        }
+        else if (network === 'optimistic' || network === 'kovan-optimistic') {
+            this.url = `https://api-${network}.etherscan.io/api`;
+            this.apikey = 'FEXS1HXVA4Y2RNTMEA8V1UTK21S4JWHH9U';
+        }
+        else if (network === 'moonbeam') {
+            this.url = 'https://api-moonbeam.moonscan.io/api';
+            this.apikey = '5EUFXW6TDC16VERF3D9SCWRRU6AEMTBHNJ';
         }
         else {
             this.url = `https://api-${network}.etherscan.io/api`;
@@ -69,8 +122,31 @@ class EtherscanParser {
      */
     async getSolidityCode(contractAddress) {
         const { files, contractName } = await this.getSourceCode(contractAddress);
+        // Parse the UmlClasses from the Solidity code in each file
+        let umlClasses = [];
+        for (const file of files) {
+            const node = await this.parseSourceCode(file.code);
+            const umlClass = (0, converterAST2Classes_1.convertAST2UmlClasses)(node, file.filename);
+            umlClasses = umlClasses.concat(umlClass);
+        }
+        // Sort the classes so dependent code is first
+        const topologicalSortedClasses = (0, filterClasses_1.topologicalSortClasses)(umlClasses);
+        // Get a list of filenames the classes are in
+        const sortedFilenames = topologicalSortedClasses.map((umlClass) => umlClass.relativePath);
+        // Remove duplicate filenames from the list
+        const dependentFilenames = [...new Set(sortedFilenames)];
+        // find any files that didn't have dependencies found
+        const nonDependentFiles = files.filter((f) => !dependentFilenames.includes(f.filename));
+        const nonDependentFilenames = nonDependentFiles.map((f) => f.filename);
         let solidityCode = '';
-        files.forEach((file) => {
+        // output non dependent code before the dependent files just in case sol2uml missed some dependencies
+        const filenames = [...nonDependentFilenames, ...dependentFilenames];
+        // For each filename
+        filenames.forEach((filename) => {
+            // Lookup the file that contains the Solidity code
+            const file = files.find((f) => f.filename === filename);
+            if (!file)
+                throw Error(`Failed to find file with filename "${filename}"`);
             // comment out any import statements
             // match whitespace before import
             // and characters after import up to ;
@@ -106,6 +182,7 @@ class EtherscanParser {
     async getSourceCode(contractAddress) {
         const description = `get verified source code for address ${contractAddress} from Etherscan API.`;
         try {
+            debug(`About to get Solidity source code for ${contractAddress} from ${this.url}`);
             const response = await axios_1.default.get(this.url, {
                 params: {
                     module: 'contract',

package/lib/sol2uml.js

@@ -10,15 +10,21 @@ const converterClasses2Storage_1 = require("./converterClasses2Storage");
 const converterStorage2Dot_1 = require("./converterStorage2Dot");
 const regEx_1 = require("./utils/regEx");
 const writerFiles_1 = require("./writerFiles");
+const path_1 = require("path");
 const program = new commander_1.Command();
+const version = (0, path_1.basename)(__dirname) === 'lib'
+    ? require('../package.json').version // used when run from compile js in /lib
+    : require('../../package.json').version; // used when run from TypeScript source files under src/ts via ts-node
+program.version(version);
 const debugControl = require('debug');
 const debug = require('debug')('sol2uml');
 program
     .usage(`[subcommand] <options>
-The three subcommands:
-* class:    Generates a UML class diagram from Solidity source code. default
+
+sol2uml comes with three subcommands:
+* class:    Generates a UML class diagram from Solidity source code. (default)
 * storage:  Generates a diagram of a contract's storage slots.
-* flatten:  Pulls verified source files from a Blockchain explorer into one, flat, local Solidity file.
+* flatten:  Merges verified source files from a Blockchain explorer into one local file.
 
 The Solidity code can be pulled from verified source code on Blockchain explorers like Etherscan or from local Solidity files.`)
     .addOption(new commander_1.Option('-sf, --subfolders <value>', 'number of subfolders that will be recursively searched for Solidity files.').default('-1', 'all'))
@@ -28,20 +34,10 @@ The Solidity code can be pulled from verified source code on Blockchain explorer
     .option('-o, --outputFileName <value>', 'output file name')
     .option('-i, --ignoreFilesOrFolders <filesOrFolders>', 'comma separated list of files or folders to ignore')
     .addOption(new commander_1.Option('-n, --network <network>', 'Ethereum network')
-    .choices([
-    'mainnet',
-    'polygon',
-    'bsc',
-    'arbitrum',
-    'ropsten',
-    'kovan',
-    'rinkeby',
-    'goerli',
-    'sepolia',
-])
+    .choices(parserEtherscan_1.networks)
     .default('mainnet')
     .env('ETH_NETWORK'))
-    .addOption(new commander_1.Option('-k, --apiKey <key>', 'Etherscan, Polygonscan, BscScan or Arbiscan API key').env('SCAN_API_KEY'))
+    .addOption(new commander_1.Option('-k, --apiKey <key>', 'Blockchain explorer API key. eg Etherscan, Arbiscan, BscScan, CronoScan, FTMScan, PolygonScan or SnowTrace API key').env('SCAN_API_KEY'))
     .option('-v, --verbose', 'run with debugging statements', false);
 program
     .command('class', { isDefault: true })
@@ -88,12 +84,16 @@ If an Ethereum address with a 0x prefix is passed, the verified source code from
         debug(`Finished generating UML`);
     }
     catch (err) {
-        console.error(`Failed to generate UML diagram\n${err.stack}`);
+        console.error(err);
+        process.exit(2);
     }
 });
 program
     .command('storage')
-    .description("Visually display a contract's storage slots.\n\nWARNING: sol2uml does not use the Solidity compiler so may differ with solc. A known example is fixed-sized arrays declared with an expression will fail to be sized.")
+    .description("Visually display a contract's storage slots.")
+    .usage(`<fileFolderAddress> [options]
+
+WARNING: sol2uml does not use the Solidity compiler so may differ with solc. A known example is fixed-sized arrays declared with an expression will fail to be sized.`)
     .argument('<fileFolderAddress>', 'file name, base folder or contract address')
     .option('-c, --contract <name>', 'Contract name in local Solidity files. Not needed when using an address as the first argument as the contract name can be derived from Etherscan.')
     .option('-d, --data', 'Gets the values in the storage slots from an Ethereum node.', false)
@@ -138,13 +138,20 @@ program
         await (0, writerFiles_1.writeOutputFiles)(dotString, fileFolderAddress, contractName || 'storageDiagram', combinedOptions.outputFormat, combinedOptions.outputFileName);
     }
     catch (err) {
-        console.error(`Failed to generate storage diagram.\n${err.stack}`);
+        console.error(err.stack);
+        process.exit(2);
     }
 });
 program
     .command('flatten')
-    .description('get all verified source code for a contract from the Blockchain explorer into one local file')
-    .argument('<contractAddress>', 'Contract address')
+    .description('Merges verified source files for a contract from a Blockchain explorer into one local file.')
+    .usage(`<contractAddress> [options]
+
+In order for the merged code to compile, the following is done:
+1. File imports are commented out.
+2. "SPDX-License-Identifier" is renamed to "SPDX--License-Identifier".
+3. Contract dependencies are analysed so the files are merged in an order that will compile.`)
+    .argument('<contractAddress>', 'Contract address in hexadecimal format with a 0x prefix.')
     .action(async (contractAddress, options, command) => {
     try {
         debug(`About to flatten ${contractAddress}`);
@@ -159,7 +166,8 @@ program
         await (0, writerFiles_1.writeSolidity)(solidityCode, outputFilename);
     }
     catch (err) {
-        console.error(`Failed to flatten files.\n${err.stack}`);
+        console.error(err);
+        process.exit(2);
     }
 });
 program.on('option:verbose', () => {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "sol2uml",
-  "version": "2.1.1",
-  "description": "Unified Modeling Language (UML) class diagram generator for Solidity contracts",
+  "version": "2.1.4",
+  "description": "Solidity contract visualisation tool.",
   "main": "./lib/index.js",
   "types": "./lib/index.d.ts",
   "scripts": {
@@ -54,14 +54,15 @@
     "UML",
     "Solidity",
     "Ethereum",
-    "Class diagram",
-    "Class",
     "diagram",
-    "Contract",
-    "Interface",
-    "Relationship",
-    "SVG",
+    "class",
+    "diagram",
+    "contract",
     "Blockchain",
-    "Model"
+    "storage",
+    "flatten",
+    "visual",
+    "tool",
+    "cli"
   ]
 }