@lionweb/utilities 0.1.0-beta.0

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2022 LionWeb Team
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/dist/id-generation.d.ts

@@ -0,0 +1,26 @@
+import { IdGenerator } from "@lionweb/core";
+/**
+ * ID generator based on the {@link https://zelark.github.io/nano-id-cc/ `nanoid` NPM package}.
+ */
+export declare const nanoIdGen: () => IdGenerator;
+declare const defaultHashAlgorithm = "SHA256";
+/**
+ * Type definition for objects that configure a
+ * {@link hashingIdGen hashing ID generator}.
+ */
+export type HashingIdGenConfig = {
+    algorithm?: typeof defaultHashAlgorithm | string;
+    salt?: string;
+    encoding?: "base64url" | "base64";
+};
+/**
+ * Creates a {@link IdGenerator hashing ID generator},
+ * optionally using a {@link HashingIdGenConfig configuration object}.
+ * The default is:
+ *   - uses the *SHA256* hashing algorithm
+ *   - without salt prefix string
+ * Note that the created ID generator must be given data in the form of a string (`!== undefined`).
+ */
+export declare const hashingIdGen: (config?: HashingIdGenConfig) => 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":"AAGA,OAAO,EAAC,WAAW,EAAC,MAAM,eAAe,CAAA;AAGzC;;GAEG;AACH,eAAO,MAAM,SAAS,QAAO,WACX,CAAA;AAGlB,QAAA,MAAM,oBAAoB,WAAW,CAAA;AAErC;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC7B,SAAS,CAAC,EAAE,OAAO,oBAAoB,GAAG,MAAM,CAAA;IAChD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,WAAW,GAAG,QAAQ,CAAA;CACpC,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,YAAa,kBAAkB,KAAG,WAc1D,CAAA"}

package/dist/id-generation.js

@@ -0,0 +1,30 @@
+import { nanoid } from "nanoid";
+import { createHash } from "crypto";
+/**
+ * ID generator based on the {@link https://zelark.github.io/nano-id-cc/ `nanoid` NPM package}.
+ */
+export const nanoIdGen = () => () => nanoid();
+const defaultHashAlgorithm = "SHA256";
+/**
+ * Creates a {@link IdGenerator hashing ID generator},
+ * optionally using a {@link HashingIdGenConfig configuration object}.
+ * The default is:
+ *   - uses the *SHA256* hashing algorithm
+ *   - without salt prefix string
+ * Note that the created ID generator must be given data in the form of a string (`!== undefined`).
+ */
+export const hashingIdGen = (config) => {
+    const algorithm = config?.algorithm ?? defaultHashAlgorithm;
+    const salt = config?.salt ?? "";
+    const encoding = config?.encoding ?? "base64url";
+    return (data) => {
+        if (data === undefined) {
+            throw new Error(`expected data for hashing`);
+        }
+        return createHash(algorithm)
+            .update(salt + data)
+            .digest(encoding)
+            .toString();
+    };
+};
+//# 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":"AAAA,OAAO,EAAC,MAAM,EAAC,MAAM,QAAQ,CAAA;AAC7B,OAAO,EAAC,UAAU,EAAC,MAAM,QAAQ,CAAA;AAKjC;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,GAAgB,EAAE,CACvC,GAAG,EAAE,CAAC,MAAM,EAAE,CAAA;AAGlB,MAAM,oBAAoB,GAAG,QAAQ,CAAA;AAYrC;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,MAA2B,EAAe,EAAE;IACrE,MAAM,SAAS,GAAG,MAAM,EAAE,SAAS,IAAI,oBAAoB,CAAA;IAC3D,MAAM,IAAI,GAAG,MAAM,EAAE,IAAI,IAAI,EAAE,CAAA;IAC/B,MAAM,QAAQ,GAAG,MAAM,EAAE,QAAQ,IAAI,WAAW,CAAA;IAEhD,OAAO,CAAC,IAAI,EAAE,EAAE;QACZ,IAAI,IAAI,KAAK,SAAS,EAAE;YACpB,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAA;SAC/C;QACD,OAAO,UAAU,CAAC,SAAS,CAAC;aACvB,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;aACnB,MAAM,CAAC,QAAQ,CAAC;aAChB,QAAQ,EAAE,CAAA;IACnB,CAAC,CAAA;AACL,CAAC,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export * from "./m3/diagrams/Mermaid-generator.js";
+export * from "./m3/diagrams/PlantUML-generator.js";
+export * from "./m3/ecore/importer.js";
+export * from "./m3/ecore/types.js";
+export * from "./m3/schema-generator.js";
+export * from "./id-generation.js";
+export * from "./json.js";
+export * from "./serialization-utils.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,oCAAoC,CAAA;AAClD,cAAc,qCAAqC,CAAA;AACnD,cAAc,wBAAwB,CAAA;AACtC,cAAc,qBAAqB,CAAA;AACnC,cAAc,0BAA0B,CAAA;AACxC,cAAc,oBAAoB,CAAA;AAClC,cAAc,WAAW,CAAA;AACzB,cAAc,0BAA0B,CAAA"}

package/dist/index.js

@@ -0,0 +1,9 @@
+export * from "./m3/diagrams/Mermaid-generator.js";
+export * from "./m3/diagrams/PlantUML-generator.js";
+export * from "./m3/ecore/importer.js";
+export * from "./m3/ecore/types.js";
+export * from "./m3/schema-generator.js";
+export * from "./id-generation.js";
+export * from "./json.js";
+export * from "./serialization-utils.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,oCAAoC,CAAA;AAClD,cAAc,qCAAqC,CAAA;AACnD,cAAc,wBAAwB,CAAA;AACtC,cAAc,qBAAqB,CAAA;AACnC,cAAc,0BAA0B,CAAA;AACxC,cAAc,oBAAoB,CAAA;AAClC,cAAc,WAAW,CAAA;AACzB,cAAc,0BAA0B,CAAA"}

package/dist/json.d.ts

@@ -0,0 +1,3 @@
+export declare const writeJsonAsFile: (path: string, json: unknown) => void;
+export declare const readFileAsJson: (path: string) => unknown;
+//# sourceMappingURL=json.d.ts.map

package/dist/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../src/json.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,eAAe,SAAU,MAAM,QAAQ,OAAO,SACd,CAAA;AAG7C,eAAO,MAAM,cAAc,SAAU,MAAM,KAAG,OACD,CAAA"}

package/dist/json.js

@@ -0,0 +1,5 @@
+import { readFileSync, writeFileSync } from "fs";
+const asPrettyString = (json) => JSON.stringify(json, null, 2);
+export const writeJsonAsFile = (path, json) => writeFileSync(path, asPrettyString(json));
+export const readFileAsJson = (path) => JSON.parse(readFileSync(path).toString());
+//# sourceMappingURL=json.js.map

package/dist/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../src/json.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAE,aAAa,EAAC,MAAM,IAAI,CAAA;AAG9C,MAAM,cAAc,GAAG,CAAC,IAAa,EAAU,EAAE,CAC7C,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;AAGjC,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,IAAY,EAAE,IAAa,EAAE,EAAE,CAC3D,aAAa,CAAC,IAAI,EAAE,cAAc,CAAC,IAAI,CAAC,CAAC,CAAA;AAG7C,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,IAAY,EAAW,EAAE,CACpD,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAA"}

package/dist/m3/diagrams/Mermaid-generator.d.ts

@@ -0,0 +1,7 @@
+import { Language } from "@lionweb/core";
+/**
+ * Generates a string with a Mermaid class diagram
+ * representing the given {@link Language LionCore instance}.
+ */
+export declare const generateMermaidForLanguage: ({ entities }: Language) => string;
+//# sourceMappingURL=Mermaid-generator.d.ts.map

package/dist/m3/diagrams/Mermaid-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Mermaid-generator.d.ts","sourceRoot":"","sources":["../../../src/m3/diagrams/Mermaid-generator.ts"],"names":[],"mappings":"AACA,OAAO,EAQH,QAAQ,EAQX,MAAM,eAAe,CAAA;AAuBtB;;;GAGG;AACH,eAAO,MAAM,0BAA0B,iBAAgB,QAAQ,WAWzD,CAAA"}

package/dist/m3/diagrams/Mermaid-generator.js

@@ -0,0 +1,93 @@
+import { asString, indentWith } from "littoral-templates";
+import { Concept, ConceptInterface, Containment, entitiesSortedByName, Enumeration, isRef, Link, nonRelationalFeatures, PrimitiveType, relationsOf, type, unresolved } from "@lionweb/core";
+// define some layouting basics/building algebra:
+const indented = indentWith(`  `)(1);
+const block = (header, elements) => elements.length === 0
+    ? header
+    : [
+        `${header} {`,
+        indented(elements),
+        `}`
+    ];
+const withNewLine = (content) => [
+    content,
+    ``
+];
+/**
+ * Generates a string with a Mermaid class diagram
+ * representing the given {@link Language LionCore instance}.
+ */
+export const generateMermaidForLanguage = ({ entities }) => asString([
+    "```mermaid",
+    `classDiagram
+
+`,
+    indented(entitiesSortedByName(entities).map(generateForElement)),
+    ``,
+    indented(entitiesSortedByName(entities).map(generateForRelationsOf)),
+    ``,
+    "```"
+]);
+const generateForEnumeration = ({ name, literals }) => withNewLine(block(`class ${name}`, [
+    `<<enumeration>>`,
+    literals.map(({ name }) => name)
+]));
+const generateForConcept = ({ name, features, abstract: abstract_, extends: extends_ /*, implements: implements_*/, partition }) => [
+    block(`class ${partition ? `<<partition>> ` : ``}${name}`, nonRelationalFeatures(features).map(generateForNonRelationalFeature)),
+    abstract_ ? `<<Abstract>> ${name}` : [],
+    isRef(extends_) ? `${extends_.name} <|-- ${name}` : [],
+    ``
+];
+const generateForConceptInterface = ({ name, features, extends: extends_ }) => [
+    block(`class ${name}`, nonRelationalFeatures(features).map(generateForNonRelationalFeature)),
+    `<<Interface>> ${name}`,
+    extends_.map(({ name: extendsName }) => `${extendsName} <|-- ${name}`),
+    ``
+];
+const generateForNonRelationalFeature = (feature) => {
+    const { name, optional } = feature;
+    const multiple = feature instanceof Link && feature.multiple;
+    const type_ = type(feature);
+    const typeText = `${multiple ? `List~` : ``}${type_ === unresolved ? `???` : type_.name}${multiple ? `~` : ``}${optional ? `?` : ``}`;
+    return `+${typeText} ${name}`;
+};
+const generateForPrimitiveType = ({ name }) => `%% primitive type: "${name}"
+
+`;
+// Note: No construct for PrimitiveType exists in PlantUML.
+const generateForElement = (element) => {
+    if (element instanceof Concept) {
+        return generateForConcept(element);
+    }
+    if (element instanceof ConceptInterface) {
+        return generateForConceptInterface(element);
+    }
+    if (element instanceof Enumeration) {
+        return generateForEnumeration(element);
+    }
+    if (element instanceof PrimitiveType) {
+        return generateForPrimitiveType(element);
+    }
+    return `// unhandled metamodel element: ${element.name}`;
+};
+const generateForRelationsOf = (element) => {
+    const relations = relationsOf(element);
+    return relations.length === 0
+        ? ``
+        : relations
+            .map((relation) => generateForRelation(element, relation));
+};
+const generateForRelation = ({ name: leftName }, relation) => {
+    const { name: relationName, optional, multiple, type } = relation;
+    const rightName = isRef(type) ? type.name : (type === unresolved ? `<unresolved>` : `<null>`);
+    const isContainment = relation instanceof Containment;
+    const leftMultiplicity = isContainment ? `1` : `*`;
+    const rightMultiplicity = (() => {
+        if (multiple) {
+            return "*";
+        }
+        return optional ? "0..1" : "1";
+    })();
+    return `${leftName} "${leftMultiplicity}" ${isContainment ? `o` : ``}-- "${rightMultiplicity}" ${rightName}: ${relationName}`;
+};
+//# sourceMappingURL=Mermaid-generator.js.map

package/dist/m3/diagrams/Mermaid-generator.js.map

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

package/dist/m3/diagrams/PlantUML-generator.d.ts

@@ -0,0 +1,7 @@
+import { Language } from "@lionweb/core";
+/**
+ * Generates a string with a PlantUML class diagram
+ * representing the given {@link Language LionCore instance}.
+ */
+export declare const generatePlantUmlForLanguage: ({ name, entities }: Language) => string;
+//# sourceMappingURL=PlantUML-generator.d.ts.map

package/dist/m3/diagrams/PlantUML-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlantUML-generator.d.ts","sourceRoot":"","sources":["../../../src/m3/diagrams/PlantUML-generator.ts"],"names":[],"mappings":"AACA,OAAO,EAQH,QAAQ,EAQX,MAAM,eAAe,CAAA;AAMtB;;;GAGG;AACH,eAAO,MAAM,2BAA2B,uBAAsB,QAAQ,WAmBpE,CAAA"}

package/dist/m3/diagrams/PlantUML-generator.js

@@ -0,0 +1,122 @@
+import { asString, indentWith } from "littoral-templates";
+import { Concept, ConceptInterface, Containment, entitiesSortedByName, Enumeration, isRef, Link, nonRelationalFeatures, PrimitiveType, relationsOf, type, unresolved } from "@lionweb/core";
+const indented = indentWith(`  `)(1);
+/**
+ * Generates a string with a PlantUML class diagram
+ * representing the given {@link Language LionCore instance}.
+ */
+export const generatePlantUmlForLanguage = ({ name, entities }) => asString([
+    `@startuml
+hide empty members
+
+' qualified name: "${name}"
+
+
+`,
+    entitiesSortedByName(entities).map(generateForElement),
+    `
+
+' relations:
+
+`,
+    entitiesSortedByName(entities).map(generateForRelationsOf),
+    `
+@enduml
+`
+]);
+const generateForEnumeration = ({ name, literals }) => [
+    `enum ${name} {`,
+    indented(literals.map(({ name }) => name)),
+    `}
+
+`
+];
+const generateForConcept = ({ name, features, abstract: abstract_, extends: extends_, implements: implements_, partition }) => {
+    const nonRelationalFeatures_ = nonRelationalFeatures(features);
+    const fragments = [];
+    if (abstract_) {
+        fragments.push(`abstract`);
+    }
+    fragments.push(`class`, name);
+    if (partition) {
+        fragments.push(`<<partition>>`);
+    }
+    if (isRef(extends_)) {
+        fragments.push(`extends`, extends_.name);
+    }
+    if (implements_.length > 0) {
+        fragments.push(`implements`, implements_.map((conceptInterface) => conceptInterface.name).sort().join(", "));
+    }
+    return nonRelationalFeatures_.length === 0
+        ? [
+            `${fragments.join(" ")}`,
+            ``
+        ]
+        : [
+            `${fragments.join(" ")} {`,
+            indented(nonRelationalFeatures_.map(generateForNonRelationalFeature)),
+            `}`,
+            ``
+        ];
+};
+const generateForConceptInterface = ({ name, extends: extends_, features }) => {
+    const nonRelationalFeatures_ = nonRelationalFeatures(features);
+    const fragments = [`interface`, name];
+    if (extends_.length > 0) {
+        fragments.push(`extends`, extends_.map((superInterface) => superInterface.name).join(", "));
+    }
+    return nonRelationalFeatures_.length === 0
+        ? `${fragments.join(" ")}`
+        : [
+            `${fragments.join(" ")} {`,
+            indented(nonRelationalFeatures_.map(generateForNonRelationalFeature)),
+            `}`,
+            ``
+        ];
+};
+const generateForNonRelationalFeature = (feature) => {
+    const { name, optional } = feature;
+    const multiple = feature instanceof Link && feature.multiple;
+    const type_ = type(feature);
+    return `${name}: ${multiple ? `List<` : ``}${type_ === unresolved ? `???` : type_.name}${multiple ? `>` : ``}${(optional && !multiple) ? ` <<optional>>` : ``}`;
+};
+const generateForPrimitiveType = ({ name }) => `' primitive type: "${name}"
+
+`;
+// Note: No construct for PrimitiveType exists in PlantUML.
+const generateForElement = (element) => {
+    if (element instanceof Enumeration) {
+        return generateForEnumeration(element);
+    }
+    if (element instanceof Concept) {
+        return generateForConcept(element);
+    }
+    if (element instanceof ConceptInterface) {
+        return generateForConceptInterface(element);
+    }
+    if (element instanceof PrimitiveType) {
+        return generateForPrimitiveType(element);
+    }
+    return `' unhandled metamodel element: ${element.name}
+`;
+};
+const generateForRelationsOf = (element) => {
+    const relations = relationsOf(element);
+    return relations.length === 0
+        ? ``
+        : relations
+            .map((relation) => generateForRelation(element, relation));
+};
+const generateForRelation = ({ name: leftName }, relation) => {
+    const { name: relationName, type, optional, multiple } = relation;
+    const rightName = isRef(type) ? type.name : (type === unresolved ? `<unresolved>` : `<null>`);
+    const isContainment = relation instanceof Containment;
+    const leftMultiplicity = isContainment ? `1` : `*`;
+    const rightMultiplicity = multiple ? "*" : (optional ? "0..1" : "1");
+    return `${leftName} "${leftMultiplicity}" ${isContainment ? `o` : ``}-- "${rightMultiplicity}" ${rightName}: ${relationName}`;
+};
+/*
+ Notes:
+    1. No construct for PrimitiveType in PlantUML.
+ */
+//# sourceMappingURL=PlantUML-generator.js.map

package/dist/m3/diagrams/PlantUML-generator.js.map

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

package/dist/m3/ecore/importer.d.ts

@@ -0,0 +1,7 @@
+import { Language } from "@lionweb/core";
+import { EcoreXml } from "./types.js";
+/**
+ * Converts a parsed Ecore XML metamodel (file) to a {@link Language LionCore instance}.
+ */
+export declare const asLionCoreLanguage: (ecoreXml: EcoreXml, version: string) => Language;
+//# sourceMappingURL=importer.d.ts.map

package/dist/m3/ecore/importer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"importer.d.ts","sourceRoot":"","sources":["../../../src/m3/ecore/importer.ts"],"names":[],"mappings":"AAAA,OAAO,EAaH,QAAQ,EAOX,MAAM,eAAe,CAAA;AAEtB,OAAO,EAAsB,QAAQ,EAA4B,MAAM,YAAY,CAAA;AAuBnF;;GAEG;AACH,eAAO,MAAM,kBAAkB,aAAc,QAAQ,WAAW,MAAM,KAAG,QAwHxE,CAAA"}

package/dist/m3/ecore/importer.js

@@ -0,0 +1,101 @@
+import { asArray, builtinPrimitives, checkDefinedData, checkUniqueData, checkUniqueId, checkValidId, duplicatesAmong, keyOf, LanguageFactory, namedsOf, qualifiedNameOf, wrapIdGen } from "@lionweb/core";
+import { hashingIdGen } from "../../id-generation.js";
+const localRefPrefix = "#//";
+/**
+ * "Dereferences" a type descriptor string by removing the optional <pre>"#//"</pre> prefix.
+ */
+const deref = (typeDescriptor) => typeDescriptor.startsWith(localRefPrefix)
+    ? typeDescriptor.substring(localRefPrefix.length)
+    : typeDescriptor;
+const { booleanDatatype, integerDatatype, stringDatatype } = builtinPrimitives;
+const typeDesc2primitiveType = {
+    "ecore:EDataType http://www.eclipse.org/emf/2002/Ecore#//EString": stringDatatype,
+    "ecore:EDataType http://www.eclipse.org/emf/2003/XMLType#//String": stringDatatype,
+    "ecore:EDataType http://www.eclipse.org/emf/2003/XMLType#//Boolean": booleanDatatype,
+    "ecore:EDataType http://www.eclipse.org/emf/2003/XMLType#//Int": integerDatatype
+};
+/**
+ * Converts a parsed Ecore XML metamodel (file) to a {@link Language LionCore instance}.
+ */
+export const asLionCoreLanguage = (ecoreXml, version) => {
+    const ePackage = ecoreXml["ecore:EPackage"];
+    // TODO (#10)  an Ecore XML can contain multiple EPackage-s
+    const factory = new LanguageFactory(ePackage["$"]["name"], version, wrapIdGen(hashingIdGen(), checkDefinedData, checkUniqueData, checkValidId, checkUniqueId));
+    // phase 1: convert EClassifiers but without their EStructuralFeatures (in the case of EClasses)
+    const convertEClassifier = (eClassifier) => {
+        const xsiType = eClassifier["$"]["xsi:type"];
+        if (xsiType === "ecore:EClass") {
+            return factory.concept(eClassifier["$"]["name"], false);
+        }
+        if (xsiType === "ecore:EEnum") {
+            return factory.enumeration(eClassifier["$"]["name"]);
+        }
+        throw new Error(`don't know how to convert an EClassifier with descriptor "${xsiType}"`);
+    };
+    // TODO (#10)  ConceptInterface?
+    const convertedEClassifiers = ePackage["eClassifiers"]
+        .map((eClassifier) => [eClassifier, convertEClassifier(eClassifier)]);
+    const eClassifierConversionFor = (eClassifierName) => convertedEClassifiers
+        .find(([source, _]) => source["$"]["name"] === eClassifierName)[1];
+    // phase 2: also convert features of EClasses
+    const convertEStructuralFeature = (container, feature) => {
+        const metaType = feature["$"]["xsi:type"];
+        const name = feature["$"]["name"];
+        switch (metaType) {
+            case "ecore:EAttribute": {
+                const typeDesc = feature["$"]["eType"];
+                const property = factory.property(container, name)
+                    .ofType(typeDesc in typeDesc2primitiveType
+                    ? typeDesc2primitiveType[typeDesc]
+                    : eClassifierConversionFor(deref(typeDesc)));
+                if (feature["$"]["lowerBound"] === "0") {
+                    property.isOptional();
+                }
+                return property;
+            }
+            case "ecore:EReference": {
+                const link = (feature["$"]["containment"]
+                    ? factory.containment(container, name)
+                    : factory.reference(container, name))
+                    .ofType(eClassifierConversionFor(deref(feature["$"]["eType"])));
+                if (feature["$"]["lowerBound"] === "0") {
+                    link.isOptional();
+                }
+                if (feature["$"]["upperBound"] === "-1") {
+                    link.isMultiple();
+                }
+                return link;
+            }
+            default:
+                throw new Error(`feature of meta type ${metaType} not handled`);
+        }
+    };
+    convertedEClassifiers.forEach(([source, target]) => {
+        const xsiType = source["$"]["xsi:type"];
+        if (xsiType === "ecore:EClass") {
+            const classifier = target;
+            classifier
+                .havingFeatures(...asArray(source.eStructuralFeatures)
+                .map((feature) => convertEStructuralFeature(classifier, feature)));
+            if (source["$"]["eSuperTypes"] !== undefined) {
+                target.extends = eClassifierConversionFor(deref(source["$"]["eSuperTypes"]));
+            }
+        }
+        if (xsiType === "ecore:EEnum") {
+            const classifier = target;
+            classifier
+                .havingLiterals(...asArray(source.eLiterals)
+                .map((literal) => factory.enumerationLiteral(classifier, literal["$"]["name"])));
+        }
+    });
+    // phase 3: put all converted things into the metamodel
+    factory.language
+        .havingEntities(...convertedEClassifiers.map(([_, mmElement]) => mmElement));
+    // phase 4: dedup keys (crudely, using the qualified name) where necessary
+    Object.entries(duplicatesAmong(namedsOf(factory.language), keyOf))
+        .forEach(([_, mmElements]) => {
+        mmElements.forEach((mmElement) => mmElement.havingKey(qualifiedNameOf(mmElement, "_")));
+    });
+    return factory.language;
+};
+//# sourceMappingURL=importer.js.map

package/dist/m3/ecore/importer.js.map

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

package/dist/m3/ecore/types.d.ts

@@ -0,0 +1,60 @@
+import { AnyNumberOf } from "@lionweb/core";
+/**
+ * Type definitions that correspond to an Ecore XML metamodel (file),
+ * parsed using the <tt>xml2js</tt> XML parser library
+ * (or with a parser exactly compatible with that.)
+ *
+ * For completeness' sake, the required code could look as follows:
+ * ```ts
+ * import {parseString} from "xml2js"
+ *
+ * parseString(data, (err, ecoreXml) => {
+ *     const language = asLionCoreLanguage(ecoreXml as EcoreXml, "1")
+ * })
+ * ```
+ * (It's assumed that {@link EcoreXml} is already imported.)
+ */
+export type ENamed = {
+    "$": {
+        "name": string;
+    };
+};
+export type EcoreXml = {
+    "ecore:EPackage": EcorePackage;
+};
+export type EcorePackage = ENamed & {
+    "eClassifiers": EClassifier[];
+};
+export type EClassifier = EClass | EEnum;
+export type EClass = ENamed & {
+    "$": {
+        "xsi:type": "ecore:EClass";
+        "eSuperTypes"?: string;
+    };
+    "eStructuralFeatures"?: AnyNumberOf<EStructuralFeature>;
+};
+export type EStructuralFeature = EAttribute | EReference;
+export type EAttribute = ENamed & {
+    "$": {
+        "xsi:type": "ecore:EAttribute";
+        "lowerBound": string;
+        "eType": string;
+    };
+};
+export type EReference = ENamed & {
+    "$": {
+        "xsi:type": "ecore:EReference";
+        "lowerBound"?: string;
+        "upperBound": string;
+        "eType": string;
+        "containment"?: boolean;
+    };
+};
+export type EEnum = ENamed & {
+    "$": {
+        "xsi:type": "ecore:EEnum";
+    };
+    "eLiterals"?: AnyNumberOf<EEnumLiteral>;
+};
+export type EEnumLiteral = ENamed;
+//# sourceMappingURL=types.d.ts.map

package/dist/m3/ecore/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/m3/ecore/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,WAAW,EAAC,MAAM,eAAe,CAAA;AAGzC;;;;;;;;;;;;;;GAcG;AAEH,MAAM,MAAM,MAAM,GAAG;IACjB,GAAG,EAAE;QACD,MAAM,EAAE,MAAM,CAAA;KACjB,CAAA;CACJ,CAAA;AAED,MAAM,MAAM,QAAQ,GAAG;IACnB,gBAAgB,EAAE,YAAY,CAAA;CACjC,CAAA;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG;IAChC,cAAc,EAAE,WAAW,EAAE,CAAA;CAChC,CAAA;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,KAAK,CAAA;AAExC,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG;IAC1B,GAAG,EAAE;QACD,UAAU,EAAE,cAAc,CAAA;QAC1B,aAAa,CAAC,EAAE,MAAM,CAAA;KACzB,CAAA;IACD,qBAAqB,CAAC,EAAE,WAAW,CAAC,kBAAkB,CAAC,CAAA;CAC1D,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG,UAAU,GAAG,UAAU,CAAA;AAExD,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG;IAC9B,GAAG,EAAE;QACD,UAAU,EAAE,kBAAkB,CAAA;QAC9B,YAAY,EAAE,MAAM,CAAA;QACpB,OAAO,EAAE,MAAM,CAAA;KAClB,CAAA;CACJ,CAAA;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG;IAC9B,GAAG,EAAE;QACD,UAAU,EAAE,kBAAkB,CAAA;QAC9B,YAAY,CAAC,EAAE,MAAM,CAAA;QACrB,YAAY,EAAE,MAAM,CAAA;QACpB,OAAO,EAAE,MAAM,CAAA;QACf,aAAa,CAAC,EAAE,OAAO,CAAA;KAC1B,CAAA;CACJ,CAAA;AAED,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG;IACzB,GAAG,EAAE;QACD,UAAU,EAAE,aAAa,CAAA;KAC5B,CAAA;IACD,WAAW,CAAC,EAAE,WAAW,CAAC,YAAY,CAAC,CAAA;CAC1C,CAAA;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,CAAA"}

package/dist/m3/ecore/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/m3/ecore/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/m3/ecore/types.ts"],"names":[],"mappings":""}

package/dist/m3/schema-generator.d.ts

@@ -0,0 +1,7 @@
+import { Language } from "@lionweb/core";
+/**
+ * Generates a JSON Schema for the LionWeb-compliant serialization JSON format
+ * specific to the (metamodel in/of the) given language.
+ */
+export declare const schemaFor: (language: Language) => unknown;
+//# sourceMappingURL=schema-generator.d.ts.map

package/dist/m3/schema-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-generator.d.ts","sourceRoot":"","sources":["../../src/m3/schema-generator.ts"],"names":[],"mappings":"AAAA,OAAO,EAYH,QAAQ,EAGX,MAAM,eAAe,CAAA;AAyFtB;;;GAGG;AACH,eAAO,MAAM,SAAS,aAAc,QAAQ,KAAG,OAgF9C,CAAA"}

package/dist/m3/schema-generator.js

@@ -0,0 +1,155 @@
+import { allFeaturesOf, Enumeration, isConcrete, isContainment, isEnumeration, isProperty, isRef, isReference, PrimitiveType } from "@lionweb/core";
+// TODO  import types for JSON Schema for added type-safety?
+const ref = (id) => ({ $ref: `#/$defs/${id}` });
+const isString = () => ({ type: "string" });
+const asJSONSchemaType = (dataType) => {
+    if (dataType instanceof Enumeration) {
+        return ref(dataType.key);
+    }
+    if (dataType instanceof PrimitiveType) {
+        // (TODO  use equality on the level of PrimitiveType instances (but builtins is not a singleton))
+        switch (dataType.name) {
+            case "String":
+            case "Boolean":
+            case "Integer":
+            case "JSON": return isString();
+            default:
+                throw new Error(`can't deal with PrimitiveType "${dataType.name}"`);
+        }
+    }
+    throw new Error(`can't handle Datatype instance: ${dataType}`);
+};
+const schemaForFeatures = (features, mapFeature, specifyRequireds) => {
+    const requireds = features.filter(({ optional }) => !optional);
+    return {
+        type: "array",
+        items: {
+        // FIXME  what here?
+        },
+        properties: Object.fromEntries(features
+            .map((feature) => [
+            feature.key,
+            mapFeature(feature)
+        ])),
+        required: specifyRequireds && requireds.length > 0
+            ? requireds.map(({ key }) => key)
+            : undefined,
+        additionalProperties: false
+    };
+};
+const schemaForProperty = (property) => isRef(property.type)
+    ? asJSONSchemaType(property.type)
+    : {}; // "any"
+const schemaForConcept = (concept) => {
+    const allFeatures = allFeaturesOf(concept);
+    return {
+        type: "object",
+        properties: {
+            id: ref("Id"),
+            concept: {
+                const: {
+                    metamodel: "LionCore_M3",
+                    version: "1",
+                    key: concept.key
+                }
+            },
+            properties: schemaForFeatures(allFeatures.filter(isProperty), schemaForProperty, true),
+            children: schemaForFeatures(allFeatures.filter(isContainment), (_) => ref("Ids"), true),
+            references: schemaForFeatures(allFeatures.filter(isReference), (_) => ref("Ids"), false),
+            parent: ref("ParentId")
+        },
+        required: [
+            "id",
+            "concept",
+            "properties",
+            "children",
+            "references"
+        ],
+        additionalProperties: false
+    };
+};
+const schemaForEnumeration = ({ literals }) => ({
+    enum: literals.map(({ name }) => name)
+});
+/**
+ * Generates a JSON Schema for the LionWeb-compliant serialization JSON format
+ * specific to the (metamodel in/of the) given language.
+ */
+export const schemaFor = (language) => {
+    const concreteConcepts = language.entities.filter(isConcrete);
+    const enumerations = language.entities.filter(isEnumeration);
+    return {
+        $schema: "https://json-schema.org/draft/2020-12/schema",
+        $id: `${language.name}-serialization`,
+        title: `Serialization format specific to ${language.name}`,
+        ...ref("SerializedModel"),
+        $defs: {
+            // TODO (#34)  put the static definitions in a separate, referred-to JSON Schema
+            "SerializedModel": {
+                type: "object",
+                properties: {
+                    serializationFormatVersion: {
+                        const: "1"
+                    },
+                    languages: {
+                        const: []
+                    },
+                    nodes: {
+                        type: "array",
+                        items: ref("SerializedNode")
+                    }
+                },
+                required: [
+                    "serializationFormatVersion",
+                    "languages",
+                    "nodes"
+                ],
+                additionalProperties: false
+            },
+            "Id": {
+                type: "string",
+                minLength: 1
+            },
+            "Ids": {
+                type: "array",
+                items: ref("Id"),
+                minItems: 1 // because empties are not allowed
+            },
+            "MetaPointer": {
+                type: "object",
+                properties: {
+                    "language": isString(),
+                    "version": isString(),
+                    "key": isString()
+                },
+                required: [
+                    "language",
+                    "version",
+                    "key"
+                ],
+                additionalProperties: false
+            },
+            "ParentId": {
+                oneOf: [
+                    ref("Id"),
+                    { type: null }
+                ]
+            },
+            ...Object.fromEntries(concreteConcepts
+                .map((element) => [
+                element.name,
+                schemaForConcept(element)
+            ])),
+            "SerializedNode": {
+                oneOf: concreteConcepts
+                    .map(({ name }) => ref(name))
+            },
+            ...Object.fromEntries(enumerations
+                .map((enumeration) => [
+                enumeration.key,
+                schemaForEnumeration(enumeration)
+            ]))
+        }
+    };
+};
+//# sourceMappingURL=schema-generator.js.map

package/dist/m3/schema-generator.js.map

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

package/dist/serialization-utils.d.ts

@@ -0,0 +1,12 @@
+import { SerializationChunk } from "@lionweb/core";
+/**
+ * @return A shortened version of a {@link SerializedModel JSON serialization}, which should make it easier to inspect.
+ *  Note that the shortened version doesn't contain all information, and could (in theory) be malformed.
+ */
+export declare const shortenedSerialization: ({ nodes }: SerializationChunk) => any[];
+/**
+ * @return A sorted version of a {@link SerializedModel JSON serialization}, which should make it easier to inspect.
+ *  Note that the sorted version destroy the order of links, which might effectively alter semantics.
+ */
+export declare const sortedSerialization: ({ serializationFormatVersion, languages, nodes }: SerializationChunk) => SerializationChunk;
+//# sourceMappingURL=serialization-utils.d.ts.map

package/dist/serialization-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization-utils.d.ts","sourceRoot":"","sources":["../src/serialization-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kBAAkB,EAAkB,MAAM,eAAe,CAAA;AAGjE;;;GAGG;AACH,eAAO,MAAM,sBAAsB,cAAa,kBAAkB,UAY3D,CAAA;AAGP;;;GAGG;AACH,eAAO,MAAM,mBAAmB,qDAAoD,kBAAkB,KAAG,kBAqBnG,CAAA"}

package/dist/serialization-utils.js

@@ -0,0 +1,41 @@
+import { sortByStringKey } from "@lionweb/core";
+/**
+ * @return A shortened version of a {@link SerializedModel JSON serialization}, which should make it easier to inspect.
+ *  Note that the shortened version doesn't contain all information, and could (in theory) be malformed.
+ */
+export const shortenedSerialization = ({ nodes }) => nodes.map((node) => ({
+    id: node.id,
+    concept: node.concept.key,
+    parent: node.parent ?? undefined,
+    ...Object.fromEntries([
+        ...node.properties.map((serProp) => [serProp.property.key, serProp.value]),
+        ...node.children.map((serContainment) => [serContainment.containment.key, serContainment.children]),
+        ...node.references.map((serReference) => [serReference.reference.key, serReference.targets.map(({ reference }) => reference)])
+    ])
+}));
+/**
+ * @return A sorted version of a {@link SerializedModel JSON serialization}, which should make it easier to inspect.
+ *  Note that the sorted version destroy the order of links, which might effectively alter semantics.
+ */
+export const sortedSerialization = ({ serializationFormatVersion, languages, nodes }) => ({
+    serializationFormatVersion,
+    languages,
+    nodes: sortByStringKey(nodes, ({ id }) => id)
+        .map((node) => ({
+        id: node.id,
+        concept: node.concept,
+        parent: node.parent,
+        properties: sortByStringKey(node.properties, ({ property }) => property.key),
+        children: sortByStringKey(node.children, ({ containment }) => containment.key)
+            .map(({ containment, children }) => ({
+            containment,
+            children: children.sort()
+        })),
+        references: sortByStringKey(node.references, ({ reference }) => reference.key)
+            .map(({ reference, targets }) => ({
+            reference,
+            targets: sortByStringKey(targets, ({ reference }) => reference)
+        }))
+    }))
+});
+//# sourceMappingURL=serialization-utils.js.map

package/dist/serialization-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization-utils.js","sourceRoot":"","sources":["../src/serialization-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,eAAe,EAAC,MAAM,eAAe,CAAA;AAGjE;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,EAAC,KAAK,EAAqB,EAAE,EAAE,CAClE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACjB,EAAE,EAAE,IAAI,CAAC,EAAE;IACX,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG;IACzB,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,SAAS;IAChC,GAAG,MAAM,CAAC,WAAW,CACjB;QACI,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QAC1E,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,cAAc,CAAC,WAAW,CAAC,GAAG,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;QACnG,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,SAAS,CAAC,GAAG,EAAE,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAC,SAAS,EAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;KAC/H,CACJ;CACJ,CAAC,CAAC,CAAA;AAGP;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,EAAC,0BAA0B,EAAE,SAAS,EAAE,KAAK,EAAqB,EAAsB,EAAE,CAC1H,CAAC;IACG,0BAA0B;IAC1B,SAAS;IACT,KAAK,EAAE,eAAe,CAAC,KAAK,EAAE,CAAC,EAAC,EAAE,EAAC,EAAE,EAAE,CAAC,EAAE,CAAC;SACtC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACZ,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,UAAU,EAAE,eAAe,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,EAAC,QAAQ,EAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC;QAC1E,QAAQ,EAAE,eAAe,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,EAAC,WAAW,EAAC,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC;aACnE,GAAG,CAAC,CAAC,EAAC,WAAW,EAAE,QAAQ,EAAC,EAAE,EAAE,CAAC,CAAC;YAC/B,WAAW;YACX,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE;SAC5B,CAAC,CAAC;QACX,UAAU,EAAE,eAAe,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,EAAC,SAAS,EAAC,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC;aACnE,GAAG,CAAC,CAAC,EAAC,SAAS,EAAE,OAAO,EAAC,EAAE,EAAE,CAAC,CAAC;YAC5B,SAAS;YACT,OAAO,EAAE,eAAe,CAAC,OAAO,EAAE,CAAC,EAAC,SAAS,EAAC,EAAE,EAAE,CAAC,SAAS,CAAC;SAChE,CAAC,CAAC;KACd,CAAC,CAAC;CACV,CAAC,CAAA"}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@lionweb/utilities",
+  "version": "0.1.0-beta.0",
+  "description": "LionWeb utilities",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "typings": "dist/index.d.ts",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/LionWeb-org/lioncore-typescript.git"
+  },
+  "bugs": {
+    "url": "https://github.com/LionWeb-org/lioncore-typescript/issues"
+  },
+  "dependencies": {
+    "@lionweb/core": "0.5.0-beta.0",
+    "littoral-templates": "^0.2.2",
+    "nanoid": "^4.0.2"
+  },
+  "devDependencies": {
+    "@types/node": "^20.6.0",
+    "typescript": "^5.2.2"
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist/ && rm -rf node_modules/"
+  }
+}