An NPM package that can be added to a Node.js/NPM codebase as follows:

$ npm add @lionweb/utilities

It contains utilities on top of the core package, such as:

• Diagram generation (PlantUML and Mermaid) from an M2.
• “Textualization”, i.e. render a serialization chunk as text.
• Sort the contents of a serialization chunk as much as possible, for the sake of comparing serialization chunks.
• An Ecore → M2 importer.

• Rename inferLanguagesFromChunk → inferLanguagesFromSerializationChunk (for consistency).
• Extend the functionality of the measure metrics function.

• Add a inferLanguagesFromChunk function that infers a language from a serialization chunk.
• Renaming for consistency and clarity:
  • readChunk → readSerializationChunk
  • tryLoad[All]AsLanguages → tryRead[All]AsLanguages
• tryReadAllAsLanguages combines all serialization chunks (that are the result of serializing Languages) into one before attempting to deserialize, in order to have cross-language references resolve.

• Add a function measure that computes metrics on a serialization chunk.

• Improve PlantUML and Mermaid diagram generation:
  • Primitive types now rendered as classes marked as "<>".
  • Concepts or Annotations that extend the "Node" concept built into LionCore don't show that.
  • Optional (single-valued) features are now shown with a question mark (?) directly after the type, instead of being marked as "<>".
  • Fix/add support for annotations.
• Remove all Ecore functionality (=issue #121)

• Add support for annotations in diagram generation (PlantUML and Mermaid), and textualization.
• Remove the shortenedSerializationChunk function, as it isn't used, nor very useful compared to the sorting and textualization.
• Breaking name changes: rename asText → languageAsText, shortenedSerialization → shortenedSerializationChunk, sortedSerialization → sortedSerializationChunk.
• Expose an isSerializedLanguages function.
• Expose an orderedSerializationChunk function that aligns the JSON key-value pairs in a serialization chunk according to the specification of the serialization format. That means that key-value pairs appear in precisely the same order as they do in the specification, and that missing key-value pairs are put in and get their default values.
• Expose a generic textual syntax for serialization chunks, through the genericTreeAsText function. This function is optionally language-aware: by providing an array of Languages as its second argument, it will try and look up LanguageEntity and Feature names instead of rendering their keys.

This is the first version corresponding to a release of LionWeb (version: 2023.1) as a whole.

• Update for the presence of annotations on a(ny) Node.
• Move the readChunk function from @lionweb/cli to @lionweb/utilities.
• Also generate TypeScript type definitions for Annotations.
• Sort everything in sortedSerialization.
• Extend textual syntax for "multi-linguality".
• Implement textual syntax for Annotations.
• Breaking change: Change ID generation to hashing (hasher function).
• (Make small, cosmetic fix in asText function.)
• Add a function tsTypesForLanguage that generates TypeScript types.
• Receive asText and ID checking from @lionweb/core.

No changelog has been kept for previous versions, regardless of whether these were published or not.

Build it from source as follows:

npm run build