@accordproject/concerto-vocabulary 4.2.0 → 5.0.0-beta.2

package/dist/esm/chunk-7RW3VXN4.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/vocabulary.ts"],
+  "sourcesContent": ["/*\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { ModelFile, ClassDeclaration, Declaration, Property } from '@accordproject/concerto-core';\nimport type VocabularyManager from './vocabularymanager';\n\n/**\n* A vocabulary for a concerto model\n* @class\n* @memberof module:concerto-vocabulary\n*/\nclass Vocabulary {\n    public vocabularyManager: VocabularyManager;\n    public content: any;\n\n    /**\n     * Create the Vocabulary\n     * @constructor\n     * @param {VocabularyManager} vocabularyManager - the manager for this vocabulary\n     * @param {object} voc - the JSON representation of the vocabulary\n     */\n    constructor(vocabularyManager: VocabularyManager, voc: any) {\n        if(!vocabularyManager) {\n            throw new Error('VocabularyManager must be specified');\n        }\n        if(!voc) {\n            throw new Error('Vocabulary object must be specified');\n        }\n\n        if(!voc.declarations) {\n            throw new Error('Vocabulary object must have declarations');\n        }\n\n        if(!voc.namespace) {\n            throw new Error('A vocabulary must specify a namespace');\n        }\n\n        if(!voc.locale) {\n            throw new Error('A vocabulary must specify a locale');\n        }\n\n        Vocabulary.validateLocale(voc.locale);\n\n        this.vocabularyManager = vocabularyManager;\n        this.content = voc;\n    }\n\n    /**\n     * Returns the namespace for the vocabulary\n     * @returns {string} the namespace for this vocabulary\n     */\n    getNamespace(): string {\n        return this.content.namespace;\n    }\n\n    /**\n     * Validates a locale\n     * @param {string} locale the locale to validate\n     * @throws {Error} if the locale is invalid\n     */\n    static validateLocale(locale: string) {\n        // @ts-ignore\n        new Intl.Locale(locale);\n        if(locale !== locale.toLowerCase()) {\n            throw new Error('Locale should be lowercase with dashes');\n        }\n    }\n\n    /**\n     * Returns the locale for the vocabulary\n     * @returns {string} the locale for this vocabulary\n     */\n    getLocale(): string {\n        return this.content.locale;\n    }\n\n    /**\n     * Returns the identifier for the vocabulary, composed of the namespace plus the locale\n     * @returns {string} the identifier for this vocabulary\n     */\n    getIdentifier(): string {\n        return `${this.getNamespace()}/${this.content.locale}`;\n    }\n\n    /**\n     * Returns all the declarations for this vocabulary\n     * @returns {Array} an array of objects\n     */\n    getTerms(): any[] {\n        return this.content.declarations;\n    }\n\n    /**\n     * Gets the terms of Namespace\n     * @returns {string} the term or null if it does not exist\n     * @private\n     */\n    getNamespaceTerms(): any {\n        const namespaceTerms = Object.entries(this.content).filter(([key]) => key !== 'namespace' && key !== 'locale' && key !== 'declarations');\n        return namespaceTerms.length > 0 ? Object.fromEntries(namespaceTerms) : null;\n    }\n\n    /**\n     * Gets the term for a concept, enum or property\n     * @param {string} declarationName the name of a concept or enum\n     * @param {string} [propertyName] the name of a property (optional)\n     * @param {string} [identifier] the identifier of the term (optional)\n     * @returns {string|number|boolean|null} the term or null if it does not exist\n     */\n    getTerm(declarationName?: string, propertyName?: string, identifier?: string): string | number | boolean | null {\n        if(!declarationName){\n            const namespaceTerms = this.getNamespaceTerms();\n            return identifier ? namespaceTerms?.[identifier]:namespaceTerms?.term;\n        }\n        const decl = this.content.declarations.find((d: any) => Object.keys(d)[0] === declarationName);\n        if(!decl) {\n            return null;\n        }\n        if(!propertyName) {\n            return identifier ? decl[identifier] : decl[declarationName];\n        }\n        else {\n            const property = decl.properties ? decl.properties.find((d: any) => propertyName in d) : null;\n            return property ? identifier ? property[identifier] : property[propertyName] : null;\n        }\n    }\n\n    /**\n     * Gets the terms for a concept, enum or property\n     * @param {string} declarationName the name of a concept or enum\n     * @param {string} [propertyName] the name of a property (optional)\n     * @returns {string} the term or null if it does not exist\n     */\n    getElementTerms(declarationName: string, propertyName?: string): any {\n        if(!declarationName){\n            return this.getNamespaceTerms();\n        }\n        const decl = this.content.declarations.find((d: any) => Object.keys(d)[0] === declarationName);\n        if(!decl) {\n            return null;\n        }\n        if(!propertyName) {\n            return decl;\n        }\n        else {\n            const property = decl.properties ? decl.properties.find((d: any) => propertyName in d) : null;\n            return property;\n        }\n    }\n\n    /**\n     * Validates a vocabulary against a ModelFile, returning errors for\n     * missing and additional terms.\n     * @param {ModelFile} modelFile the model file for this vocabulary\n     * @returns {*} an object with missingTerms and additionalTerms properties\n     */\n    validate(modelFile: ModelFile): any {\n        const getOwnProperties = (declaration: any) => {\n            // ensures we have a valid return, even for scalars and map-declarations\n            if(declaration.isMapDeclaration()) {\n                return [declaration.getKey(), declaration.getValue()];\n            } else {\n                return declaration.getOwnProperties?.() ? declaration.getOwnProperties?.() : [];\n            }\n        };\n\n        const getPropertyName = (property: any) => {\n            if(property.isKey?.()) {\n                return 'KEY';\n            } else if(property.isValue?.()) {\n                return 'VALUE';\n            } else {\n                return property.getName();\n            }\n        };\n\n        const checkPropertyExists = (k: any, p: any) => {\n            // only reached for keys that getLocalType has already resolved\n            const declaration = modelFile.getLocalType(Object.keys(k)[0]) as ClassDeclaration;\n            const property = Object.keys(p)[0];\n            if(declaration.isMapDeclaration()) {\n                if (property === 'KEY') {\n                    return true;\n                } else if(property === 'VALUE') {\n                    return true;\n                } else {\n                    return false;\n                }\n            } else {\n                return declaration.getOwnProperty(Object.keys(p)[0]);\n            }\n        };\n\n        const result = {\n            missingTerms: modelFile.getAllDeclarations().flatMap( (d: Declaration) => this.getTerm(d.getName())\n                ? getOwnProperties(d).flatMap( (p: Property) => this.getTerm(d.getName(), getPropertyName(p)) ? null : `${d.getName()}.${getPropertyName(p)}`)\n                : d.getName() ).filter( (i: any) => i !== null),\n            additionalTerms: this.content.declarations.flatMap( (k: any) => modelFile.getLocalType(Object.keys(k)[0])\n                ? Array.isArray(k.properties) ? k.properties.flatMap( (p: any) => checkPropertyExists(k, p) ? null : `${Object.keys(k)[0]}.${Object.keys(p)[0]}`) : null\n                : k ).filter( (i: any) => i !== null)\n        };\n\n        if(!this.content.term){\n            result.missingTerms.push('namespace');\n        }\n\n        return result;\n    }\n\n    /**\n     * Converts the object to JSON\n     * @returns {*} the contens of this vocabulary\n     */\n    toJSON() {\n        return this.content;\n    }\n}\n\nexport { Vocabulary };\nexport default Vocabulary;\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/esm/chunk-TA74NV57.mjs

@@ -0,0 +1,38 @@
+import { createRequire as __createRequire } from "module";
+const require = __createRequire(import.meta.url);
+
+// src/yamlparser.ts
+import YAML from "yaml";
+function parseVocabularyYaml(yamlStr) {
+  const doc = YAML.parseDocument(yamlStr);
+  if (doc.errors.length > 0) {
+    throw doc.errors[0];
+  }
+  YAML.visit(doc, {
+    Pair(_, pair) {
+      const key = pair.key.value;
+      const value = pair.value;
+      if (key === "declarations" || key === "properties") {
+        return;
+      }
+      if (YAML.isScalar(value) && typeof value.value !== "string") {
+        pair.value = new YAML.Scalar(String(value.value));
+        return;
+      }
+      if (YAML.isCollection(value)) {
+        if (value.range) {
+          const [start, end] = value.range;
+          pair.value = new YAML.Scalar(yamlStr.substring(start, end));
+        } else {
+          pair.value = new YAML.Scalar(JSON.stringify(value.toJSON()));
+        }
+      }
+    }
+  });
+  return doc.toJSON();
+}
+
+export {
+  parseVocabularyYaml
+};
+//# sourceMappingURL=chunk-TA74NV57.mjs.map

package/dist/esm/chunk-TA74NV57.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/yamlparser.ts"],
+  "sourcesContent": ["/*\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport YAML from 'yaml';\n\n/**\n * Parses vocabulary YAML, ensuring all non-structural collection values remain strings.\n * YAML.parse can incorrectly interpret flow syntax (e.g. {\u0427\u043E\u0432\u0435\u043A} or [value])\n * as objects/arrays \u2014 in vocabularies, these should be preserved as literal strings.\n * Only 'declarations' and 'properties' are kept as actual collections.\n * @param {string} yamlStr the YAML string to parse\n * @returns {*} the parsed vocabulary object\n */\nexport function parseVocabularyYaml(yamlStr: string): any {\n    const doc = YAML.parseDocument(yamlStr);\n    if (doc.errors.length > 0) {\n        throw doc.errors[0];\n    }\n    YAML.visit(doc, {\n        Pair(_, pair) {\n            const key = (pair.key as YAML.Scalar).value;\n            const value = pair.value;\n\n            if (key === 'declarations' || key === 'properties') {\n                return;\n            }\n\n            if (YAML.isScalar(value) && typeof value.value !== 'string') {\n                pair.value = new YAML.Scalar(String(value.value));\n                return;\n            }\n\n            if (YAML.isCollection(value)) {\n                if (value.range) {\n                    const [start, end] = value.range as [number, number, number];\n                    pair.value = new YAML.Scalar(yamlStr.substring(start, end));\n                } else {\n                    pair.value = new YAML.Scalar(JSON.stringify(value.toJSON()));\n                }\n            }\n        },\n    });\n    return doc.toJSON();\n}\n"],
+  "mappings": ";;;;AAcA,OAAO,UAAU;AAUV,SAAS,oBAAoB,SAAsB;AACtD,QAAM,MAAM,KAAK,cAAc,OAAO;AACtC,MAAI,IAAI,OAAO,SAAS,GAAG;AACvB,UAAM,IAAI,OAAO,CAAC;AAAA,EACtB;AACA,OAAK,MAAM,KAAK;AAAA,IACZ,KAAK,GAAG,MAAM;AACV,YAAM,MAAO,KAAK,IAAoB;AACtC,YAAM,QAAQ,KAAK;AAEnB,UAAI,QAAQ,kBAAkB,QAAQ,cAAc;AAChD;AAAA,MACJ;AAEA,UAAI,KAAK,SAAS,KAAK,KAAK,OAAO,MAAM,UAAU,UAAU;AACzD,aAAK,QAAQ,IAAI,KAAK,OAAO,OAAO,MAAM,KAAK,CAAC;AAChD;AAAA,MACJ;AAEA,UAAI,KAAK,aAAa,KAAK,GAAG;AAC1B,YAAI,MAAM,OAAO;AACb,gBAAM,CAAC,OAAO,GAAG,IAAI,MAAM;AAC3B,eAAK,QAAQ,IAAI,KAAK,OAAO,QAAQ,UAAU,OAAO,GAAG,CAAC;AAAA,QAC9D,OAAO;AACH,eAAK,QAAQ,IAAI,KAAK,OAAO,KAAK,UAAU,MAAM,OAAO,CAAC,CAAC;AAAA,QAC/D;AAAA,MACJ;AAAA,IACJ;AAAA,EACJ,CAAC;AACD,SAAO,IAAI,OAAO;AACtB;",
+  "names": []
+}

package/dist/esm/index.mjs

@@ -0,0 +1,14 @@
+import { createRequire as __createRequire } from "module";
+const require = __createRequire(import.meta.url);
+import {
+  vocabularymanager_default
+} from "./chunk-3VH3UOGB.mjs";
+import {
+  vocabulary_default
+} from "./chunk-7RW3VXN4.mjs";
+import "./chunk-TA74NV57.mjs";
+export {
+  vocabulary_default as Vocabulary,
+  vocabularymanager_default as VocabularyManager
+};
+//# sourceMappingURL=index.mjs.map

package/dist/esm/index.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/esm/vocabulary.mjs

@@ -0,0 +1,11 @@
+import { createRequire as __createRequire } from "module";
+const require = __createRequire(import.meta.url);
+import {
+  Vocabulary,
+  vocabulary_default
+} from "./chunk-7RW3VXN4.mjs";
+export {
+  Vocabulary,
+  vocabulary_default as default
+};
+//# sourceMappingURL=vocabulary.mjs.map

package/dist/esm/vocabulary.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/esm/vocabularymanager.mjs

@@ -0,0 +1,13 @@
+import { createRequire as __createRequire } from "module";
+const require = __createRequire(import.meta.url);
+import {
+  VocabularyManager,
+  vocabularymanager_default
+} from "./chunk-3VH3UOGB.mjs";
+import "./chunk-7RW3VXN4.mjs";
+import "./chunk-TA74NV57.mjs";
+export {
+  VocabularyManager,
+  vocabularymanager_default as default
+};
+//# sourceMappingURL=vocabularymanager.mjs.map

package/dist/esm/vocabularymanager.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/esm/yamlparser.mjs

@@ -0,0 +1,9 @@
+import { createRequire as __createRequire } from "module";
+const require = __createRequire(import.meta.url);
+import {
+  parseVocabularyYaml
+} from "./chunk-TA74NV57.mjs";
+export {
+  parseVocabularyYaml
+};
+//# sourceMappingURL=yamlparser.mjs.map

package/dist/esm/yamlparser.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}