@lionweb/core 0.5.0-beta.0

package/dist/id-generation.d.ts

@@ -0,0 +1,54 @@
+type GenData = string | undefined;
+/**
+ * Type definition for a function that generates a unique ID,
+ * possibly ingesting some data.
+ */
+export type IdGenerator = (data: GenData) => string;
+/**
+ * ID generator that produces sequential IDs:
+ * `"1"`, `"2"`, `"3"`, …
+ */
+export declare const sequentialIdGen: () => IdGenerator;
+/**
+ * Augments the given {@link IdGenerator ID generator} by checking
+ * whether it's been given unique {@link GenData data},
+ * throwing an error when not.
+ */
+export declare const checkUniqueData: (idGen: IdGenerator) => IdGenerator;
+/**
+ * Augments the given {@link IdGenerator ID generator} by checking
+ * whether it's been given defined ({@code !== undefined}) data,
+ * throwing an error when not.
+ */
+export declare const checkDefinedData: (idGen: IdGenerator) => IdGenerator;
+/**
+ * Augments the given {@link IdGenerator ID generator} by checking
+ * whether that returns unique IDs, throwing an error when not.
+ */
+export declare const checkUniqueId: (idGen: IdGenerator) => IdGenerator;
+/**
+ * Augments the given {@link IdGenerator ID generator} by checking
+ * whether it returns valid IDs, meaning [Base64URL](https://www.base64url.com/).
+ * (See also [Wikipedia](https://en.wikipedia.org/wiki/Base64#Variants_summary_table).)
+ * If a generated ID is not valid, an error is thrown.
+ */
+export declare const checkValidId: (idGen: IdGenerator) => IdGenerator;
+/**
+ * Type definition for transformers of {@link IdGenerator ID generators}.
+ */
+export type IdGenTransformer = (idGen: IdGenerator) => IdGenerator;
+/**
+ * Wraps the given ("initial") {@link IdGenerator ID generator}
+ * with the given {@link IdGenTransformer ID generator transformers}.
+ * In other words:
+ *
+ *      wrap(idGen, trafo1, trafo2, ..., trafoN) === trafoN(...trafo2(trafo1(idGen)))
+ */
+export declare const wrapIdGen: (idGen: IdGenerator, ...idGenTransformers: IdGenTransformer[]) => IdGenerator;
+/**
+ * Wraps the given ("initial") {@link IdGenerator ID generator} with all
+ * {@link IdGenTransformer ID generator checkers} defined above.
+ */
+export declare const checkAll: (idGen: IdGenerator) => IdGenerator;
+export {};
+//# sourceMappingURL=id-generation.d.ts.map

package/dist/id-generation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id-generation.d.ts","sourceRoot":"","sources":["../src/id-generation.ts"],"names":[],"mappings":"AAAA,KAAK,OAAO,GAAG,MAAM,GAAG,SAAS,CAAA;AAEjC;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,OAAO,KAAK,MAAM,CAAA;AAInD;;;GAGG;AACH,eAAO,MAAM,eAAe,QAAO,WAGlC,CAAA;AAMD;;;;GAIG;AACH,eAAO,MAAM,eAAe,UAAW,WAAW,KAAG,WASpD,CAAA;AAGD;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,UAAW,WAAW,KAAG,WAMjD,CAAA;AAGL;;;GAGG;AACH,eAAO,MAAM,aAAa,UAAW,WAAW,KAAG,WAWlD,CAAA;AAGD;;;;;GAKG;AACH,eAAO,MAAM,YAAY,UAAW,WAAW,KAAG,WAO7C,CAAA;AAGL;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,WAAW,KAAK,WAAW,CAAA;AAElE;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,UAAW,WAAW,wBAAwB,gBAAgB,EAAE,KAAG,WACtB,CAAA;AAGnE;;;GAGG;AACH,eAAO,MAAM,QAAQ,UAAW,WAAW,KAAG,WAOzC,CAAA"}

package/dist/id-generation.js

@@ -0,0 +1,76 @@
+/**
+ * ID generator that produces sequential IDs:
+ * `"1"`, `"2"`, `"3"`, …
+ */
+export const sequentialIdGen = () => {
+    let num = 0;
+    return () => `${++num}`;
+};
+/**
+ * Augments the given {@link IdGenerator ID generator} by checking
+ * whether it's been given unique {@link GenData data},
+ * throwing an error when not.
+ */
+export const checkUniqueData = (idGen) => {
+    const datas = [];
+    return (data) => {
+        if (datas.indexOf(data) > -1) {
+            throw new Error(`duplicate data encountered: "${data}"`);
+        }
+        datas.push(data);
+        return idGen(data);
+    };
+};
+/**
+ * Augments the given {@link IdGenerator ID generator} by checking
+ * whether it's been given defined ({@code !== undefined}) data,
+ * throwing an error when not.
+ */
+export const checkDefinedData = (idGen) => (data) => {
+    if (data === undefined) {
+        throw new Error(`expected data`);
+    }
+    return idGen(data);
+};
+/**
+ * Augments the given {@link IdGenerator ID generator} by checking
+ * whether that returns unique IDs, throwing an error when not.
+ */
+export const checkUniqueId = (idGen) => {
+    const ids = [];
+    return (data) => {
+        const id = idGen(data);
+        if (ids.indexOf(id) > -1) {
+            throw new Error(`duplicate ID generated: "${id}"`);
+        }
+        ids.push(id);
+        return id;
+    };
+};
+/**
+ * Augments the given {@link IdGenerator ID generator} by checking
+ * whether it returns valid IDs, meaning [Base64URL](https://www.base64url.com/).
+ * (See also [Wikipedia](https://en.wikipedia.org/wiki/Base64#Variants_summary_table).)
+ * If a generated ID is not valid, an error is thrown.
+ */
+export const checkValidId = (idGen) => (data) => {
+    const id = idGen(data);
+    if (!id.match(/^[A-Za-z0-9_-]+$/)) {
+        throw new Error(`generated ID is not valid: ${id}`);
+    }
+    return id;
+};
+/**
+ * Wraps the given ("initial") {@link IdGenerator ID generator}
+ * with the given {@link IdGenTransformer ID generator transformers}.
+ * In other words:
+ *
+ *      wrap(idGen, trafo1, trafo2, ..., trafoN) === trafoN(...trafo2(trafo1(idGen)))
+ */
+export const wrapIdGen = (idGen, ...idGenTransformers) => idGenTransformers.reduce((acc, current) => current(acc), idGen);
+/**
+ * Wraps the given ("initial") {@link IdGenerator ID generator} with all
+ * {@link IdGenTransformer ID generator checkers} defined above.
+ */
+export const checkAll = (idGen) => wrapIdGen(idGen, checkDefinedData, checkUniqueData, checkValidId, checkUniqueId);
+//# sourceMappingURL=id-generation.js.map

package/dist/id-generation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id-generation.js","sourceRoot":"","sources":["../src/id-generation.ts"],"names":[],"mappings":"AAUA;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,GAAgB,EAAE;IAC7C,IAAI,GAAG,GAAG,CAAC,CAAA;IACX,OAAO,GAAG,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,CAAA;AAC3B,CAAC,CAAA;AAMD;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAAkB,EAAe,EAAE;IAC/D,MAAM,KAAK,GAAc,EAAE,CAAA;IAC3B,OAAO,CAAC,IAAI,EAAE,EAAE;QACZ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE;YAC1B,MAAM,IAAI,KAAK,CAAC,gCAAgC,IAAI,GAAG,CAAC,CAAA;SAC3D;QACD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAChB,OAAO,KAAK,CAAC,IAAI,CAAC,CAAA;IACtB,CAAC,CAAA;AACL,CAAC,CAAA;AAGD;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAkB,EAAe,EAAE,CAChE,CAAC,IAAI,EAAE,EAAE;IACL,IAAI,IAAI,KAAK,SAAS,EAAE;QACpB,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAA;KACnC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,CAAA;AACtB,CAAC,CAAA;AAGL;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAkB,EAAe,EAAE;IAC7D,MAAM,GAAG,GAAa,EAAE,CAAA;IAExB,OAAO,CAAC,IAAI,EAAE,EAAE;QACZ,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,CAAA;QACtB,IAAI,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE;YACtB,MAAM,IAAI,KAAK,CAAC,4BAA4B,EAAE,GAAG,CAAC,CAAA;SACrD;QACD,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACZ,OAAO,EAAE,CAAA;IACb,CAAC,CAAA;AACL,CAAC,CAAA;AAGD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,KAAkB,EAAe,EAAE,CAC5D,CAAC,IAAI,EAAE,EAAE;IACL,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,CAAA;IACtB,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,kBAAkB,CAAC,EAAE;QAC/B,MAAM,IAAI,KAAK,CAAC,8BAA8B,EAAE,EAAE,CAAC,CAAA;KACtD;IACD,OAAO,EAAE,CAAA;AACb,CAAC,CAAA;AAQL;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAkB,EAAE,GAAG,iBAAqC,EAAe,EAAE,CACnG,iBAAiB,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAA;AAGnE;;;GAGG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,KAAkB,EAAe,EAAE,CACxD,SAAS,CACL,KAAK,EACL,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,aAAa,CAChB,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export * from "./api.js";
+export * from "./types.js";
+export * from "./deserializer.js";
+export * from "./dynamic-api.js";
+export * from "./functions.js";
+export * from "./id-generation.js";
+export * from "./references.js";
+export * from "./serializer.js";
+export * from "./serialization.js";
+export * from "./m3/index.js";
+export * from "./utils/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,cAAc,YAAY,CAAA;AAC1B,cAAc,mBAAmB,CAAA;AACjC,cAAc,kBAAkB,CAAA;AAChC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,oBAAoB,CAAA;AAClC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,oBAAoB,CAAA;AAClC,cAAc,eAAe,CAAA;AAC7B,cAAc,kBAAkB,CAAA"}

package/dist/index.js

@@ -0,0 +1,12 @@
+export * from "./api.js";
+export * from "./types.js";
+export * from "./deserializer.js";
+export * from "./dynamic-api.js";
+export * from "./functions.js";
+export * from "./id-generation.js";
+export * from "./references.js";
+export * from "./serializer.js";
+export * from "./serialization.js";
+export * from "./m3/index.js";
+export * from "./utils/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,cAAc,YAAY,CAAA;AAC1B,cAAc,mBAAmB,CAAA;AACjC,cAAc,kBAAkB,CAAA;AAChC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,oBAAoB,CAAA;AAClC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,oBAAoB,CAAA;AAClC,cAAc,eAAe,CAAA;AAC7B,cAAc,kBAAkB,CAAA"}

package/dist/m3/api.d.ts

@@ -0,0 +1,16 @@
+import { ReadModelAPI, WriteModelAPI } from "../api.js";
+import { M3Concept } from "./types.js";
+import { KeyGenerator } from "./key-generation.js";
+export declare const lioncoreReadAPI: ReadModelAPI<M3Concept>;
+/**
+ * @return An implementation of {@link WriteModelAPI write-part of the model API} for instances of the LionCore M3 (so M2s).
+ * The returned {@link ModelAPI model API} uses the given {@link KeyGenerator key generator} to generate the keys of all objects in the M2.
+ */
+export declare const lioncoreWriteAPIWithKeyGen: (keyGen: KeyGenerator) => WriteModelAPI<M3Concept>;
+/**
+ * An implementation of {@link WriteModelAPI} for instances of the LionCore M3 (so M2s), where key = name.
+ *
+ * TODO  deprecate this: [de-]serialization of metamodels should be parametrized with key generation throughout
+ */
+export declare const lioncoreWriteAPI: WriteModelAPI<M3Concept>;
+//# sourceMappingURL=api.d.ts.map

package/dist/m3/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/m3/api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAA2B,aAAa,EAAC,MAAM,WAAW,CAAA;AAC9E,OAAO,EAQH,SAAS,EAIZ,MAAM,YAAY,CAAA;AAInB,OAAO,EAAC,YAAY,EAAqB,MAAM,qBAAqB,CAAA;AAMpE,eAAO,MAAM,eAAe,EAAE,YAAY,CAAC,SAAS,CAMlD,CAAA;AAGF;;;GAGG;AACH,eAAO,MAAM,0BAA0B,WAAY,YAAY,KAAG,cAAc,SAAS,CA6BvF,CAAA;AAGF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,0BAAiD,CAAA"}

package/dist/m3/api.js

@@ -0,0 +1,55 @@
+import { updateSettingsNameBased } from "../api.js";
+import { Concept, ConceptInterface, Containment, Enumeration, EnumerationLiteral, Language, PrimitiveType, Property, Reference } from "./types.js";
+import { builtinFeatures } from "./builtins.js";
+import { lioncore, metaConcepts, metaFeatures } from "./lioncore.js";
+import { classBasedConceptDeducerFor, qualifiedNameOf } from "./functions.js";
+import { nameIsKeyGenerator } from "./key-generation.js";
+const { inamed_name } = builtinFeatures;
+export const lioncoreReadAPI = ({
+    conceptOf: classBasedConceptDeducerFor(lioncore),
+    getFeatureValue: (node, feature) => 
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    node[feature.name],
+    enumerationLiteralFrom: (value, _) => value
+});
+/**
+ * @return An implementation of {@link WriteModelAPI write-part of the model API} for instances of the LionCore M3 (so M2s).
+ * The returned {@link ModelAPI model API} uses the given {@link KeyGenerator key generator} to generate the keys of all objects in the M2.
+ */
+export const lioncoreWriteAPIWithKeyGen = (keyGen) => ({
+    nodeFor: (parent, concept, id, propertySettings) => {
+        switch (concept.key) {
+            case metaConcepts.concept.key:
+                return new Concept(parent, propertySettings[inamed_name.key], "", id, propertySettings[metaFeatures.concept_abstract.key]).keyed(keyGen);
+            case metaConcepts.conceptInterface.key:
+                return new ConceptInterface(parent, propertySettings[inamed_name.key], "", id).keyed(keyGen);
+            case metaConcepts.containment.key:
+                return new Containment(parent, propertySettings[inamed_name.key], "", id).keyed(keyGen);
+            case metaConcepts.enumeration.key:
+                return new Enumeration(parent, propertySettings[inamed_name.key], "", id).keyed(keyGen);
+            case metaConcepts.enumerationLiteral.key:
+                return new EnumerationLiteral(parent, propertySettings[inamed_name.key], "", id).keyed(keyGen);
+            case metaConcepts.language.key:
+                return new Language(propertySettings[inamed_name.key], propertySettings[metaFeatures.language_version.key], id, propertySettings[metaFeatures.ikeyed_key.key]);
+            case metaConcepts.primitiveType.key:
+                return new PrimitiveType(parent, propertySettings[inamed_name.key], "", id).keyed(keyGen);
+            case metaConcepts.property.key:
+                return new Property(parent, propertySettings[inamed_name.key], "", id).keyed(keyGen);
+            case metaConcepts.reference.key:
+                return new Reference(parent, propertySettings[inamed_name.key], "", id).keyed(keyGen);
+            default:
+                throw new Error(`can't deserialize a node of concept "${qualifiedNameOf(concept)}" with key "${concept.key}"`);
+        }
+    },
+    setFeatureValue: (node, feature, value) => {
+        updateSettingsNameBased(node, feature, value);
+    },
+    encodingOf: (literal) => literal
+});
+/**
+ * An implementation of {@link WriteModelAPI} for instances of the LionCore M3 (so M2s), where key = name.
+ *
+ * TODO  deprecate this: [de-]serialization of metamodels should be parametrized with key generation throughout
+ */
+export const lioncoreWriteAPI = lioncoreWriteAPIWithKeyGen(nameIsKeyGenerator);
+//# sourceMappingURL=api.js.map

package/dist/m3/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/m3/api.ts"],"names":[],"mappings":"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"}

package/dist/m3/builtins.d.ts

@@ -0,0 +1,24 @@
+import { Property } from "./types.js";
+/**
+ * Definition of a LionCore language that serves as a standard library of built-in primitive types.
+ */
+declare const lioncoreBuiltins: import("./types.js").Language;
+type BuiltinPrimitive = string | boolean | number | Record<string, unknown> | Array<unknown>;
+declare const builtinPrimitives: {
+    stringDatatype: import("./types.js").PrimitiveType;
+    booleanDatatype: import("./types.js").PrimitiveType;
+    integerDatatype: import("./types.js").PrimitiveType;
+    jsonDatatype: import("./types.js").PrimitiveType;
+};
+declare const builtinClassifiers: {
+    node: import("./types.js").Concept;
+    inamed: import("./types.js").ConceptInterface;
+};
+declare const builtinFeatures: {
+    inamed_name: Property;
+};
+declare const serializeBuiltin: (value: BuiltinPrimitive) => string;
+declare const deserializeBuiltin: (value: string | undefined, property: Property) => BuiltinPrimitive | undefined;
+export type { BuiltinPrimitive };
+export { lioncoreBuiltins, builtinPrimitives, builtinClassifiers, builtinFeatures, serializeBuiltin, deserializeBuiltin };
+//# sourceMappingURL=builtins.d.ts.map

package/dist/m3/builtins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtins.d.ts","sourceRoot":"","sources":["../../src/m3/builtins.ts"],"names":[],"mappings":"AACA,OAAO,EAAgD,QAAQ,EAAC,MAAM,YAAY,CAAA;AAYlF;;GAEG;AACH,QAAA,MAAM,gBAAgB,+BAAmB,CAAA;AA8BzC,KAAK,gBAAgB,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,CAAA;AAE5F,QAAA,MAAM,iBAAiB;;;;;CAKtB,CAAA;AAED,QAAA,MAAM,kBAAkB;;;CAGvB,CAAA;AAED,QAAA,MAAM,eAAe;;CAEpB,CAAA;AAGD,QAAA,MAAM,gBAAgB,UAAW,gBAAgB,KAAG,MAcnD,CAAA;AAGD,QAAA,MAAM,kBAAkB,UAAW,MAAM,GAAG,SAAS,YAAY,QAAQ,KAAG,gBAAgB,GAAG,SAgB9F,CAAA;AAGD,YAAY,EACR,gBAAgB,EACnB,CAAA;AAED,OAAO,EACH,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EACrB,CAAA"}

package/dist/m3/builtins.js

@@ -0,0 +1,67 @@
+import { LanguageFactory } from "./factory.js";
+import { lioncoreBuiltinsQName, lioncoreQNameSeparator } from "./types.js";
+import { qualifiedNameBasedKeyGenerator } from "./key-generation.js";
+import { checkAll } from "../id-generation.js";
+const factory = new LanguageFactory(lioncoreBuiltinsQName, "1", checkAll((qualifiedName) => qualifiedName), qualifiedNameBasedKeyGenerator(lioncoreQNameSeparator));
+/**
+ * Definition of a LionCore language that serves as a standard library of built-in primitive types.
+ */
+const lioncoreBuiltins = factory.language;
+const stringDatatype = factory.primitiveType("String");
+const booleanDatatype = factory.primitiveType("Boolean");
+const integerDatatype = factory.primitiveType("Integer");
+const jsonDatatype = factory.primitiveType("JSON");
+const node = factory.concept("Node", true);
+const inamed = factory.conceptInterface("INamed");
+const inamed_name = factory.property(inamed, "name")
+    .ofType(stringDatatype);
+inamed.havingFeatures(inamed_name);
+lioncoreBuiltins.havingEntities(stringDatatype, booleanDatatype, integerDatatype, jsonDatatype, node, inamed);
+const builtinPrimitives = {
+    stringDatatype,
+    booleanDatatype,
+    integerDatatype,
+    jsonDatatype
+};
+const builtinClassifiers = {
+    node,
+    inamed
+};
+const builtinFeatures = {
+    inamed_name
+};
+const serializeBuiltin = (value) => {
+    switch (typeof value) {
+        case "string": return value;
+        case "boolean": return `${value}`;
+        case "number": return `${value}`; // TODO  check whether integer?
+        case "object": {
+            try {
+                return JSON.stringify(value, null);
+            }
+            catch (_) {
+                // pass-through
+            }
+        }
+    }
+    throw new Error(`can't serialize value of built-in primitive type: ${value}`);
+};
+const deserializeBuiltin = (value, property) => {
+    if (value === undefined) {
+        if (property.optional) {
+            return undefined;
+        }
+        throw new Error(`can't deserialize undefined as the value of a required property`);
+    }
+    const { type } = property;
+    switch (type.name) {
+        case "String": return value;
+        case "Boolean": return JSON.parse(value);
+        case "Integer": return Number(value);
+        case "JSON": return JSON.parse(value);
+        default:
+            throw new Error(`can't deserialize value of type "${type.name}": ${value}`);
+    }
+};
+export { lioncoreBuiltins, builtinPrimitives, builtinClassifiers, builtinFeatures, serializeBuiltin, deserializeBuiltin };
+//# sourceMappingURL=builtins.js.map

package/dist/m3/builtins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtins.js","sourceRoot":"","sources":["../../src/m3/builtins.ts"],"names":[],"mappings":"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"}

package/dist/m3/constraints.d.ts

@@ -0,0 +1,16 @@
+import { Language, M3Concept } from "./types.js";
+/**
+ * Type definition for an issue corresponding
+ * to a violation of a constraint on a {@link M3Concept language object}.
+ */
+export type Issue = {
+    location: M3Concept;
+    message: string;
+    secondaries: M3Concept[];
+};
+/**
+ * Computes the {@link Issue issues} (i.e., constraint violations) for the given language.
+ * (This computation is resilient against e.g. inheritance cycles.)
+ */
+export declare const issuesLanguage: (language: Language) => Issue[];
+//# sourceMappingURL=constraints.d.ts.map

package/dist/m3/constraints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constraints.d.ts","sourceRoot":"","sources":["../../src/m3/constraints.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsC,QAAQ,EAAE,SAAS,EAAC,MAAM,YAAY,CAAA;AAKnF;;;GAGG;AACH,MAAM,MAAM,KAAK,GAAG;IAChB,QAAQ,EAAE,SAAS,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,SAAS,EAAE,CAAA;CAC3B,CAAA;AAID;;;GAGG;AACH,eAAO,MAAM,cAAc,aAAc,QAAQ,KAAG,KAAK,EA2CpD,CAAA"}

package/dist/m3/constraints.js

@@ -0,0 +1,40 @@
+import { Concept, ConceptInterface, isINamed } from "./types.js";
+import { flatMap, inheritedCycleWith, keyOf, namedsOf, qualifiedNameOf } from "./functions.js";
+import { duplicatesAmong } from "../utils/grouping.js";
+// TODO  back this type with an M2
+/**
+ * Computes the {@link Issue issues} (i.e., constraint violations) for the given language.
+ * (This computation is resilient against e.g. inheritance cycles.)
+ */
+export const issuesLanguage = (language) => [
+    ...flatMap(language, (t) => {
+        const issues = [];
+        const issue = (message, secondaries) => {
+            issues.push({
+                location: t,
+                message,
+                secondaries: secondaries ?? []
+            });
+        };
+        if (t instanceof Concept || t instanceof ConceptInterface) {
+            const cycle = inheritedCycleWith(t);
+            if (cycle.length > 0) {
+                issue(`A ${t.constructor.name} can't inherit (directly or indirectly) from itself, but ${qualifiedNameOf(t)} does so through the following cycle: ${cycle.map((t) => qualifiedNameOf(t)).join(" -> ")}`);
+            }
+        }
+        if (isINamed(t)) {
+            if (t.name.trim().length === 0) {
+                issue(`A ${t.constructor.name} must have a non-whitespace name`);
+            }
+        }
+        return issues;
+    }),
+    ...Object.entries(duplicatesAmong(namedsOf(language), keyOf))
+        .flatMap(([key, ts]) => ts.map((t) => ({ location: t, message: `Multiple (nested) language elements with the same key "${key}" exist in this language`, secondaries: ts.filter((otherT) => t !== otherT) }))),
+    ...Object.entries(duplicatesAmong(namedsOf(language), qualifiedNameOf))
+        .flatMap(([key, ts]) => ts.map((t) => ({ location: t, message: `Multiple (nested) language elements with the same key "${key}" exist in this language`, secondaries: ts.filter((otherT) => t !== otherT) })))
+];
+// not here: duplicate IDs and unresolved references are a problem on a lower level
+// TODO (#8)  check uniqueness of IDs
+// TODO (#8)  check whether references are resolved
+//# sourceMappingURL=constraints.js.map

package/dist/m3/constraints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constraints.js","sourceRoot":"","sources":["../../src/m3/constraints.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAsB,MAAM,YAAY,CAAA;AACnF,OAAO,EAAC,OAAO,EAAE,kBAAkB,EAAE,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAC,MAAM,gBAAgB,CAAA;AAC5F,OAAO,EAAC,eAAe,EAAC,MAAM,sBAAsB,CAAA;AAYpD,kCAAkC;AAGlC;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,QAAkB,EAAW,EAAE,CAC1D;IACI,GAAG,OAAO,CACN,QAAQ,EACR,CAAC,CAAC,EAAE,EAAE;QAEF,MAAM,MAAM,GAAY,EAAE,CAAA;QAC1B,MAAM,KAAK,GAAG,CAAC,OAAe,EAAE,WAAyB,EAAQ,EAAE;YAC/D,MAAM,CAAC,IAAI,CAAC;gBACR,QAAQ,EAAE,CAAC;gBACX,OAAO;gBACP,WAAW,EAAE,WAAW,IAAI,EAAE;aACjC,CAAC,CAAA;QACN,CAAC,CAAA;QAED,IAAI,CAAC,YAAY,OAAO,IAAI,CAAC,YAAY,gBAAgB,EAAE;YACvD,MAAM,KAAK,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAA;YACnC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE;gBAClB,KAAK,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,IAAI,4DAA4D,eAAe,CAAC,CAAC,CAAC,yCAAyC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;aAC3M;SACJ;QAED,IAAI,QAAQ,CAAC,CAAC,CAAC,EAAE;YACb,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE;gBAC5B,KAAK,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,IAAI,kCAAkC,CAAC,CAAA;aACnE;SACJ;QAED,OAAO,MAAM,CAAA;IACjB,CAAC,CACJ;IACD,GAAG,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,CAAC;SACxD,OAAO,CACJ,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,CACjB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,0DAA0D,GAAG,0BAA0B,EAAE,WAAW,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,MAAM,CAAC,EAAE,CAAC,CAC/K,CACJ;IACL,GAAG,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,eAAe,CAAC,CAAC;SAClE,OAAO,CACJ,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,CACjB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,0DAA0D,GAAG,0BAA0B,EAAE,WAAW,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,MAAM,CAAC,EAAE,CAAC,CAC/K,CACJ;CACR,CAAA;AAGL,mFAAmF;AACnF,qCAAqC;AACrC,mDAAmD"}

package/dist/m3/deserializer.d.ts

@@ -0,0 +1,8 @@
+import { Language } from "./types.js";
+import { SerializationChunk } from "../serialization.js";
+/**
+ * Deserializes a language that's serialized into the LionWeb serialization JSON format
+ * as an instance of the LionCore metametamodel, using {@link _M3Concept these type definitions}.
+ */
+export declare const deserializeLanguage: (serializationChunk: SerializationChunk, ...dependentMetamodels: Language[]) => Language;
+//# sourceMappingURL=deserializer.d.ts.map

package/dist/m3/deserializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deserializer.d.ts","sourceRoot":"","sources":["../../src/m3/deserializer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,QAAQ,EAAC,MAAM,YAAY,CAAA;AACnC,OAAO,EAAC,kBAAkB,EAAC,MAAM,qBAAqB,CAAA;AAQtD;;;GAGG;AACH,eAAO,MAAM,mBAAmB,uBAAwB,kBAAkB,0BAA0B,QAAQ,EAAE,KAAG,QAShH,CAAA"}

package/dist/m3/deserializer.js

@@ -0,0 +1,16 @@
+import { lioncoreReadAPI, lioncoreWriteAPI } from "./api.js";
+import { nodesExtractorUsing } from "../api.js";
+import { deserializeChunk } from "../deserializer.js";
+import { lioncore } from "./lioncore.js";
+import { lioncoreBuiltins } from "./builtins.js";
+/**
+ * Deserializes a language that's serialized into the LionWeb serialization JSON format
+ * as an instance of the LionCore metametamodel, using {@link _M3Concept these type definitions}.
+ */
+export const deserializeLanguage = (serializationChunk, ...dependentMetamodels) => {
+    const language = deserializeChunk(serializationChunk, lioncoreWriteAPI, [lioncore], [lioncoreBuiltins, ...dependentMetamodels].flatMap(nodesExtractorUsing(lioncoreReadAPI)))[0];
+    language.dependingOn(...dependentMetamodels);
+    return language;
+};
+// TODO  pass a function that can resolve dependent metamodels, since they'd generally only known in the serialization
+//# sourceMappingURL=deserializer.js.map

package/dist/m3/deserializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deserializer.js","sourceRoot":"","sources":["../../src/m3/deserializer.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,eAAe,EAAE,gBAAgB,EAAC,MAAM,UAAU,CAAA;AAC1D,OAAO,EAAC,mBAAmB,EAAC,MAAM,WAAW,CAAA;AAC7C,OAAO,EAAC,gBAAgB,EAAC,MAAM,oBAAoB,CAAA;AACnD,OAAO,EAAC,QAAQ,EAAC,MAAM,eAAe,CAAA;AACtC,OAAO,EAAC,gBAAgB,EAAC,MAAM,eAAe,CAAA;AAG9C;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,kBAAsC,EAAE,GAAG,mBAA+B,EAAY,EAAE;IACxH,MAAM,QAAQ,GAAG,gBAAgB,CAC7B,kBAAkB,EAClB,gBAAgB,EAChB,CAAC,QAAQ,CAAC,EACV,CAAC,gBAAgB,EAAE,GAAG,mBAAmB,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAAC,eAAe,CAAC,CAAC,CAC3F,CAAC,CAAC,CAAa,CAAA;IAChB,QAAQ,CAAC,WAAW,CAAC,GAAG,mBAAmB,CAAC,CAAA;IAC5C,OAAO,QAAQ,CAAA;AACnB,CAAC,CAAA;AACD,sHAAsH"}

package/dist/m3/factory.d.ts

@@ -0,0 +1,26 @@
+import { Annotation, Classifier, Concept, ConceptInterface, Containment, Enumeration, EnumerationLiteral, Language, PrimitiveType, Property, Reference } from "./types.js";
+import { SingleRef } from "../references.js";
+import { IdGenerator } from "../id-generation.js";
+import { KeyGenerator } from "./key-generation.js";
+/**
+ * A factory that produces a {@link Language} instance,
+ * as well as elements contained by that instance.
+ * The {@link https://zelark.github.io/nano-id-cc/ `nanoid`-based} ID generator
+ * is used, unless specified otherwise.
+ */
+export declare class LanguageFactory {
+    readonly id: IdGenerator;
+    readonly key: KeyGenerator;
+    readonly language: Language;
+    constructor(name: string, version: string, id: IdGenerator, key?: KeyGenerator);
+    annotation(name: string, extends_?: SingleRef<Annotation>): Annotation;
+    concept(name: string, abstract: boolean, extends_?: SingleRef<Concept>): Concept;
+    conceptInterface(name: string): ConceptInterface;
+    enumeration(name: string): Enumeration;
+    primitiveType(name: string): PrimitiveType;
+    containment(classifier: Classifier, name: string): Containment;
+    property(classifier: Classifier, name: string): Property;
+    reference(classifier: Classifier, name: string): Reference;
+    enumerationLiteral(enumeration: Enumeration, name: string): EnumerationLiteral;
+}
+//# sourceMappingURL=factory.d.ts.map

package/dist/m3/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/m3/factory.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,UAAU,EACV,UAAU,EACV,OAAO,EACP,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,QAAQ,EAER,aAAa,EACb,QAAQ,EACR,SAAS,EACZ,MAAM,YAAY,CAAA;AACnB,OAAO,EAAC,SAAS,EAAC,MAAM,kBAAkB,CAAA;AAC1C,OAAO,EAAC,WAAW,EAAC,MAAM,qBAAqB,CAAA;AAE/C,OAAO,EAAC,YAAY,EAAqB,MAAM,qBAAqB,CAAA;AAUpE;;;;;GAKG;AACH,qBAAa,eAAe;IAExB,QAAQ,CAAC,EAAE,EAAE,WAAW,CAAA;IACxB,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAA;IAC1B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;gBAEf,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,WAAW,EAAE,GAAG,GAAE,YAAiC;IAUlG,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,SAAS,CAAC,UAAU,CAAC;IAIzD,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,SAAS,CAAC,OAAO,CAAC;IAItE,gBAAgB,CAAC,IAAI,EAAE,MAAM;IAI7B,WAAW,CAAC,IAAI,EAAE,MAAM;IAIxB,aAAa,CAAC,IAAI,EAAE,MAAM;IAK1B,WAAW,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM;IAIhD,QAAQ,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM;IAI7C,SAAS,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM;IAK9C,kBAAkB,CAAC,WAAW,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM;CAI5D"}

package/dist/m3/factory.js

@@ -0,0 +1,48 @@
+import { Annotation, Concept, ConceptInterface, Containment, Enumeration, EnumerationLiteral, Language, lioncoreQNameSeparator, PrimitiveType, Property, Reference } from "./types.js";
+import { qualifiedNameOf } from "./functions.js";
+import { nameIsKeyGenerator } from "./key-generation.js";
+const concat = (...names) => names.join(lioncoreQNameSeparator);
+const unkeyed = "!--no key generated--!";
+/**
+ * A factory that produces a {@link Language} instance,
+ * as well as elements contained by that instance.
+ * The {@link https://zelark.github.io/nano-id-cc/ `nanoid`-based} ID generator
+ * is used, unless specified otherwise.
+ */
+export class LanguageFactory {
+    constructor(name, version, id, key = nameIsKeyGenerator) {
+        this.id = id;
+        this.key = key;
+        const idAndKey = this.id(name); // need to call this.id just once
+        this.language = new Language(name, version, idAndKey, idAndKey);
+    }
+    // TODO  this pattern (post-re-setting the key) is not nice: improve...
+    annotation(name, extends_) {
+        return new Annotation(this.language, name, unkeyed, this.id(concat(this.language.name, name)), extends_).keyed(this.key);
+    }
+    concept(name, abstract, extends_) {
+        return new Concept(this.language, name, unkeyed, this.id(concat(this.language.name, name)), abstract, extends_).keyed(this.key);
+    }
+    conceptInterface(name) {
+        return new ConceptInterface(this.language, name, unkeyed, this.id(concat(this.language.name, name))).keyed(this.key);
+    }
+    enumeration(name) {
+        return new Enumeration(this.language, name, unkeyed, this.id(concat(this.language.name, name))).keyed(this.key);
+    }
+    primitiveType(name) {
+        return new PrimitiveType(this.language, name, unkeyed, this.id(concat(this.language.name, name))).keyed(this.key);
+    }
+    containment(classifier, name) {
+        return new Containment(classifier, name, unkeyed, this.id(concat(qualifiedNameOf(classifier, lioncoreQNameSeparator), name))).keyed(this.key);
+    }
+    property(classifier, name) {
+        return new Property(classifier, name, unkeyed, this.id(concat(qualifiedNameOf(classifier, lioncoreQNameSeparator), name))).keyed(this.key);
+    }
+    reference(classifier, name) {
+        return new Reference(classifier, name, unkeyed, this.id(concat(qualifiedNameOf(classifier, lioncoreQNameSeparator), name))).keyed(this.key);
+    }
+    enumerationLiteral(enumeration, name) {
+        return new EnumerationLiteral(enumeration, name, unkeyed, this.id(concat(qualifiedNameOf(enumeration, lioncoreQNameSeparator), name))).keyed(this.key);
+    }
+}
+//# sourceMappingURL=factory.js.map

package/dist/m3/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/m3/factory.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,UAAU,EAEV,OAAO,EACP,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,QAAQ,EACR,sBAAsB,EACtB,aAAa,EACb,QAAQ,EACR,SAAS,EACZ,MAAM,YAAY,CAAA;AAGnB,OAAO,EAAC,eAAe,EAAC,MAAM,gBAAgB,CAAA;AAC9C,OAAO,EAAe,kBAAkB,EAAC,MAAM,qBAAqB,CAAA;AAGpE,MAAM,MAAM,GAAG,CAAC,GAAG,KAAe,EAAU,EAAE,CAC1C,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAA;AAGtC,MAAM,OAAO,GAAG,wBAAwB,CAAA;AAGxC;;;;;GAKG;AACH,MAAM,OAAO,eAAe;IAMxB,YAAY,IAAY,EAAE,OAAe,EAAE,EAAe,EAAE,MAAoB,kBAAkB;QAC9F,IAAI,CAAC,EAAE,GAAG,EAAE,CAAA;QACZ,IAAI,CAAC,GAAG,GAAG,GAAG,CAAA;QACd,MAAM,QAAQ,GAAG,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,CAAA,CAAE,iCAAiC;QACjE,IAAI,CAAC,QAAQ,GAAG,IAAI,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAA;IACnE,CAAC;IAGD,uEAAuE;IAEvE,UAAU,CAAC,IAAY,EAAE,QAAgC;QACrD,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAC5H,CAAC;IAED,OAAO,CAAC,IAAY,EAAE,QAAiB,EAAE,QAA6B;QAClE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACnI,CAAC;IAED,gBAAgB,CAAC,IAAY;QACzB,OAAO,IAAI,gBAAgB,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACxH,CAAC;IAED,WAAW,CAAC,IAAY;QACpB,OAAO,IAAI,WAAW,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACnH,CAAC;IAED,aAAa,CAAC,IAAY;QACtB,OAAO,IAAI,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACrH,CAAC;IAGD,WAAW,CAAC,UAAsB,EAAE,IAAY;QAC5C,OAAO,IAAI,WAAW,CAAC,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,eAAe,CAAC,UAAU,EAAE,sBAAsB,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACjJ,CAAC;IAED,QAAQ,CAAC,UAAsB,EAAE,IAAY;QACzC,OAAO,IAAI,QAAQ,CAAC,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,eAAe,CAAC,UAAU,EAAE,sBAAsB,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAC9I,CAAC;IAED,SAAS,CAAC,UAAsB,EAAE,IAAY;QAC1C,OAAO,IAAI,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,eAAe,CAAC,UAAU,EAAE,sBAAsB,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAC/I,CAAC;IAGD,kBAAkB,CAAC,WAAwB,EAAE,IAAY;QACrD,OAAO,IAAI,kBAAkB,CAAC,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,eAAe,CAAC,WAAW,EAAE,sBAAsB,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAC1J,CAAC;CAEJ"}