@lionweb/core 0.7.0-alpha.5 → 0.7.0-alpha.7

package/dist/serializer.d.ts

@@ -1,12 +1,20 @@
 import { LionWebJsonChunk, LionWebJsonMetaPointer } from "@lionweb/json";
-import { ExtractionFacade } from "./facade.js";
-import { Feature, Property } from "./m3/types.js";
+import { Reader } from "./reading.js";
 import { Node } from "./types.js";
-export interface PrimitiveTypeSerializer {
-    serializeValue(value: unknown, property: Property): string | undefined;
+import { Feature, Property } from "./m3/types.js";
+/**
+ * Interface for objects that expose a method to serialize a property's value.
+ */
+export interface PropertyValueSerializer {
+    serializeValue(value: unknown, property: Property): string | null;
+}
+/**
+ * Misspelled alias of {@link PropertyValueSerializer}, kept for backward compatibility, and to be deprecated and removed later.
+ */
+export interface PrimitiveTypeSerializer extends PropertyValueSerializer {
 }
 /**
- * Type to provide options to the serializer.
+ * Type to provide (non-required) options to the serializer.
  */
 export type SerializationOptions = Partial<{
     /**
@@ -15,14 +23,27 @@ export type SerializationOptions = Partial<{
      * Default = true, meaning that empty feature values are *not* skipped.
      */
     serializeEmptyFeatures: boolean;
-    primitiveTypeSerializer: PrimitiveTypeSerializer;
+    /**
+     * A {@link PropertyValueSerializer} implementation.
+     * Default = DefaultPropertyValueSerializer.
+     */
+    propertyValueSerializer: PropertyValueSerializer;
+    /**
+     * Misspelled alias of {@link #propertyValueSerializer}, kept for backward compatibility, and to be deprecated and removed later.
+     */
+    primitiveTypeSerializer: PropertyValueSerializer;
 }>;
 /**
  * @return the {@link LionWebJsonMetaPointer} for the given {@link Feature}.
  */
 export declare const metaPointerFor: (feature: Feature) => LionWebJsonMetaPointer;
+/**
+ * @return a function that serializes the {@link Node nodes} passed to it.
+ */
+export declare const nodeSerializer: <NT extends Node>(reader: Reader<NT>, serializationOptions?: SerializationOptions) => (nodes: NT[]) => LionWebJsonChunk;
 /**
  * @return a {@link LionWebJsonChunk} of the given model (i.e., an array of {@link Node nodes} - the first argument) to the LionWeb serialization JSON format.
+ *  <em>Note:</em> this function will be deprecated and removed later — use {@link nodeSerializer} instead.
  */
-export declare const serializeNodes: <NT extends Node>(nodes: NT[], extractionFacade: ExtractionFacade<NT>, primitiveTypeSerializerOrOptions?: PrimitiveTypeSerializer | SerializationOptions) => LionWebJsonChunk;
+export declare const serializeNodes: <NT extends Node>(nodes: NT[], reader: Reader<NT>, propertyValueSerializerOrOptions?: PropertyValueSerializer | SerializationOptions) => LionWebJsonChunk;
 //# sourceMappingURL=serializer.d.ts.map

package/dist/serializer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serializer.d.ts","sourceRoot":"","sources":["../src/serializer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgD,gBAAgB,EAAE,sBAAsB,EAAmB,MAAM,eAAe,CAAA;AAEvI,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAI9C,OAAO,EAA4B,OAAO,EAA2B,QAAQ,EAAgC,MAAM,eAAe,CAAA;AAClI,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAGjC,MAAM,WAAW,uBAAuB;IACpC,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAA;CACzE;AAKD;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,OAAO,CAAC;IACvC;;;;OAIG;IACH,sBAAsB,EAAE,OAAO,CAAA;IAE/B,uBAAuB,EAAE,uBAAuB,CAAA;CACnD,CAAC,CAAA;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,YAAa,OAAO,KAAG,sBAOjD,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,4GAGY,uBAAuB,GAAG,oBAAoB,KAClF,gBAoHF,CAAA"}
+{"version":3,"file":"serializer.d.ts","sourceRoot":"","sources":["../src/serializer.ts"],"names":[],"mappings":"AAAA,OAAO,EAGH,gBAAgB,EAChB,sBAAsB,EAEzB,MAAM,eAAe,CAAA;AAGtB,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAGjC,OAAO,EAGH,OAAO,EAGP,QAAQ,EAGX,MAAM,eAAe,CAAA;AAGtB;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACpC,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI,CAAA;CACpE;AAED;;GAEG;AACH,MAAM,WAAW,uBAAwB,SAAQ,uBAAuB;CAAG;AAQ3E;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,OAAO,CAAC;IACvC;;;;OAIG;IACH,sBAAsB,EAAE,OAAO,CAAA;IAE/B;;;OAGG;IACH,uBAAuB,EAAE,uBAAuB,CAAA;IAEhD;;OAEG;IACH,uBAAuB,EAAE,uBAAuB,CAAA;CACnD,CAAC,CAAA;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,YAAa,OAAO,KAAG,sBAOjD,CAAA;AAGD;;GAEG;AACH,eAAO,MAAM,cAAc,+DAAgE,oBAAoB,sBAKrF,gBA8GzB,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,wFAGY,uBAAuB,GAAG,oBAAoB,KAClF,gBAQS,CAAA"}

package/dist/serializer.js

@@ -1,10 +1,10 @@
 import { currentSerializationFormatVersion } from "@lionweb/json";
 import { asArray } from "@lionweb/ts-utils";
 import { asIds } from "./functions.js";
-import { DefaultPrimitiveTypeSerializer } from "./m3/builtins.js";
+import { BuiltinPropertyValueSerializer } from "./m3/builtins.js";
 import { allFeaturesOf } from "./m3/functions.js";
 import { Containment, Enumeration, PrimitiveType, Property, Reference, simpleNameDeducer } from "./m3/types.js";
-const isPrimitiveTypeSerializer = (value) => typeof value === "object" && value !== null && "serializeValue" in value && typeof value.serializeValue === "function";
+const isPropertyValueSerializer = (value) => typeof value === "object" && value !== null && "serializeValue" in value && typeof value.serializeValue === "function";
 /**
  * @return the {@link LionWebJsonMetaPointer} for the given {@link Feature}.
  */
@@ -17,114 +17,122 @@ export const metaPointerFor = (feature) => {
     };
 };
 /**
- * @return a {@link LionWebJsonChunk} of the given model (i.e., an array of {@link Node nodes} - the first argument) to the LionWeb serialization JSON format.
+ * @return a function that serializes the {@link Node nodes} passed to it.
  */
-export const serializeNodes = (nodes, extractionFacade, primitiveTypeSerializerOrOptions) => {
-    const primitiveTypeSerializer = (isPrimitiveTypeSerializer(primitiveTypeSerializerOrOptions)
-        ? primitiveTypeSerializerOrOptions
-        : primitiveTypeSerializerOrOptions?.primitiveTypeSerializer) ?? new DefaultPrimitiveTypeSerializer();
-    const serializeEmptyFeatures = isPrimitiveTypeSerializer(primitiveTypeSerializerOrOptions)
-        ? true
-        : (primitiveTypeSerializerOrOptions?.serializeEmptyFeatures ?? true);
-    const serializedNodes = []; // keep nodes as much as possible "in order"
-    const ids = {}; // maintain a map to keep track of IDs of nodes that have been serialized
-    const languagesUsed = [];
-    const registerLanguageUsed = (language) => {
-        if (!languagesUsed.some(languageUsed => language.equals(languageUsed))) {
-            languagesUsed.push(language);
-        }
-    };
-    const visit = (node, parent) => {
-        if (ids[node.id]) {
-            return;
-        }
-        const classifier = extractionFacade.classifierOf(node);
-        const language = classifier.language;
-        registerLanguageUsed(language);
-        const serializedNode = {
-            id: node.id,
-            classifier: classifier.metaPointer(),
-            properties: [],
-            containments: [],
-            references: [],
-            annotations: [],
-            parent: null
+export const nodeSerializer = (reader, serializationOptions) => {
+    const propertyValueSerializer = serializationOptions?.propertyValueSerializer ?? serializationOptions?.primitiveTypeSerializer ?? new BuiltinPropertyValueSerializer();
+    const serializeEmptyFeatures = serializationOptions?.serializeEmptyFeatures ?? true;
+    return (nodes) => {
+        const serializedNodes = []; // keep nodes as much as possible "in order"
+        const ids = {}; // maintain a map to keep track of IDs of nodes that have been serialized
+        const languagesUsed = [];
+        const registerLanguageUsed = (language) => {
+            if (!languagesUsed.some(languageUsed => language.equals(languageUsed))) {
+                languagesUsed.push(language);
+            }
+            // TODO  could make this more efficient by using a hash table
         };
-        serializedNodes.push(serializedNode);
-        ids[node.id] = true;
-        allFeaturesOf(classifier).forEach(feature => {
-            const value = extractionFacade.getFeatureValue(node, feature);
-            const featureLanguage = feature.classifier.language;
-            registerLanguageUsed(featureLanguage);
-            const featureMetaPointer = metaPointerFor(feature);
-            if (feature instanceof Property) {
-                if (value === undefined && !serializeEmptyFeatures) {
-                    // for immediate backward compatibility: skip empty property values regardless of options?.skipEmptyValues
+        const visit = (node, parent) => {
+            if (node.id in ids) {
+                return;
+            }
+            const classifier = reader.classifierOf(node);
+            const language = classifier.language;
+            registerLanguageUsed(language);
+            const serializedNode = {
+                id: node.id,
+                classifier: classifier.metaPointer(),
+                properties: [],
+                containments: [],
+                references: [],
+                annotations: [],
+                parent: null
+            };
+            serializedNodes.push(serializedNode);
+            ids[node.id] = true;
+            allFeaturesOf(classifier).forEach(feature => {
+                const value = reader.getFeatureValue(node, feature);
+                const featureLanguage = feature.classifier.language;
+                registerLanguageUsed(featureLanguage);
+                const featureMetaPointer = metaPointerFor(feature);
+                if (feature instanceof Property) {
+                    if (value === undefined && !serializeEmptyFeatures) {
+                        // for immediate backward compatibility: skip empty property values regardless of options?.skipEmptyValues
+                        return;
+                    }
+                    const encodedValue = (() => {
+                        // (could also just inspect type of value:)
+                        if (feature.type instanceof PrimitiveType) {
+                            return propertyValueSerializer.serializeValue(value, feature);
+                        }
+                        if (feature.type instanceof Enumeration) {
+                            return reader.enumerationLiteralFrom(value, feature.type)?.key;
+                        }
+                        return undefined;
+                    })();
+                    serializedNode.properties.push({
+                        property: featureMetaPointer,
+                        value: encodedValue ?? null // (undefined -> null)
+                    });
                     return;
                 }
-                const encodedValue = (() => {
-                    // (could also just inspect type of value:)
-                    if (feature.type instanceof PrimitiveType) {
-                        return primitiveTypeSerializer.serializeValue(value, feature);
-                    }
-                    if (feature.type instanceof Enumeration) {
-                        return extractionFacade.enumerationLiteralFrom(value, feature.type)?.key;
+                if (feature instanceof Containment) {
+                    const children = asArray(value);
+                    if (children.length === 0 && !serializeEmptyFeatures) {
+                        return;
                     }
-                    return undefined;
-                })();
-                serializedNode.properties.push({
-                    property: featureMetaPointer,
-                    value: encodedValue ?? null // (undefined -> null)
-                });
-                return;
-            }
-            if (feature instanceof Containment) {
-                const children = asArray(value);
-                if (children.length === 0 && !serializeEmptyFeatures) {
+                    serializedNode.containments.push({
+                        containment: featureMetaPointer,
+                        children: asIds(children)
+                            .filter(childId => childId !== null)
+                            .map(childId => childId)
+                    });
+                    children.forEach(childOrNull => {
+                        if (childOrNull !== null) {
+                            visit(childOrNull, node);
+                        }
+                    });
                     return;
                 }
-                serializedNode.containments.push({
-                    containment: featureMetaPointer,
-                    children: asIds(children)
-                        .filter(childId => childId !== null)
-                        .map(childId => childId)
-                });
-                children.forEach(childOrNull => {
-                    if (childOrNull !== null) {
-                        visit(childOrNull, node);
+                if (feature instanceof Reference) {
+                    // Note: value can be null === typeof unresolved, e.g. on an unset (or previously unresolved) single-valued reference
+                    const targets = asArray(value);
+                    if (targets.length === 0 && !serializeEmptyFeatures) {
+                        return;
                     }
-                });
-                return;
-            }
-            if (feature instanceof Reference) {
-                // Note: value can be null === typeof unresolved, e.g. on an unset (or previously unresolved) single-valued reference
-                const targets = asArray(value);
-                if (targets.length === 0 && !serializeEmptyFeatures) {
+                    serializedNode.references.push({
+                        reference: featureMetaPointer,
+                        targets: targets
+                            .filter(tOrNull => tOrNull !== null) // (skip "non-connected" targets)
+                            .map(t => t)
+                            .map(t => ({
+                            resolveInfo: (reader.resolveInfoFor ? reader.resolveInfoFor(t) : simpleNameDeducer(t)) ?? null,
+                            reference: t.id
+                        }))
+                    });
                     return;
                 }
-                serializedNode.references.push({
-                    reference: featureMetaPointer,
-                    targets: targets
-                        .filter(tOrNull => tOrNull !== null) // (skip "non-connected" targets)
-                        .map(t => t)
-                        .map(t => ({
-                        resolveInfo: (extractionFacade.resolveInfoFor ? extractionFacade.resolveInfoFor(t) : simpleNameDeducer(t)) ?? null,
-                        reference: t.id
-                    }))
-                });
-                return;
-            }
-        });
-        const annotations = asArray(node.annotations); // assumes that annotations also all are of type NT (which is not unreasonable)
-        serializedNode.annotations = annotations.map(annotation => annotation.id);
-        annotations.forEach(annotation => visit(annotation, node));
-        serializedNode.parent = parent?.id ?? null; // (undefined -> null)
-    };
-    nodes.forEach(node => visit(node, undefined));
-    return {
-        serializationFormatVersion: currentSerializationFormatVersion,
-        languages: languagesUsed.map(({ key, version }) => ({ key, version })),
-        nodes: serializedNodes
+            });
+            const annotations = asArray(node.annotations); // assumes that annotations also all are of type NT (which is not unreasonable)
+            serializedNode.annotations = annotations.map(annotation => annotation.id);
+            annotations.forEach(annotation => visit(annotation, node));
+            serializedNode.parent = parent?.id ?? null; // (undefined -> null)
+        };
+        nodes.forEach(node => visit(node, undefined));
+        return {
+            serializationFormatVersion: currentSerializationFormatVersion,
+            languages: languagesUsed.map(({ key, version }) => ({ key, version })),
+            nodes: serializedNodes
+        };
     };
 };
+/**
+ * @return a {@link LionWebJsonChunk} of the given model (i.e., an array of {@link Node nodes} - the first argument) to the LionWeb serialization JSON format.
+ *  <em>Note:</em> this function will be deprecated and removed later — use {@link nodeSerializer} instead.
+ */
+export const serializeNodes = (nodes, reader, propertyValueSerializerOrOptions) => nodeSerializer(reader, isPropertyValueSerializer(propertyValueSerializerOrOptions)
+    ? {
+        propertyValueSerializer: propertyValueSerializerOrOptions
+    }
+    : propertyValueSerializerOrOptions)(nodes);
 //# sourceMappingURL=serializer.js.map

package/dist/serializer.js.map

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

package/dist/writing.d.ts

@@ -0,0 +1,49 @@
+import { LionWebId, LionWebKey } from "@lionweb/json";
+import { Classifier, EnumerationLiteral, Feature } from "./m3/types.js";
+import { Node } from "./types.js";
+/**
+ * An interface that's used to parametrize generic deserialization of serialization chunks to
+ * (in-memory) nodes of the given type (parameter).
+ * Implementations of these interfaces {w|c}ould be:
+ *  - specific to LionCore (so to match m3/types.ts)
+ * - generic to deserialize into {@link DynamicNode dynamic nodes}
+ */
+export interface Writer<NT extends Node, PNT extends Node = NT> {
+    /**
+     * @return An instance of the given concept, also given its parent (or {@link undefined} for root nodes),
+     * its ID and the values of the node's properties ("settings").
+     * (The latter may be required as arguments for the constructor of a class, whose instances represent nodes.)
+     */
+    nodeFor: (parent: PNT | undefined, classifier: Classifier, id: LionWebId, propertySettings: {
+        [propertyKey: LionWebKey]: unknown;
+    }) => NT;
+    /**
+     * Sets the *single* given value of the indicated {@link Feature} on the given node.
+     * This means adding it in case the feature is multi-valued, meaning it is a {@link Link} with {@code multiple = true}.
+     */
+    setFeatureValue: (node: NT, feature: Feature, value: unknown) => void;
+    /**
+     * @return The runtime encoding of the given {@link EnumerationLiteral}.
+     */
+    encodingOf: (literal: EnumerationLiteral) => unknown;
+}
+/**
+ * Alias for {@link Writer}, kept for backward compatibility, and to be deprecated and removed later.
+ */
+export interface InstantiationFacade<NT extends Node, PNT extends Node = NT> extends Writer<NT, PNT> {
+}
+/**
+ * Type def. for functions that update features’ values on a settings object.
+ */
+export type SettingsUpdater = (settings: Record<string, unknown>, feature: Feature, value: unknown) => void;
+/**
+ * Updates the value of the given {@link Feature feature} on the given "settings" object
+ * (either a {@link Node node} or a sub object of it), using the feature's *name*.
+ */
+export declare const updateSettingsNameBased: SettingsUpdater;
+/**
+ * Updates the value of the given {@link Feature feature} on the given "settings" object
+ * (either a {@link Node node} or a sub object of it), using the feature's *key*.
+ */
+export declare const updateSettingsKeyBased: SettingsUpdater;
+//# sourceMappingURL=writing.d.ts.map

package/dist/writing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writing.d.ts","sourceRoot":"","sources":["../src/writing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAErD,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,OAAO,EAAQ,MAAM,eAAe,CAAA;AAC7E,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAGjC;;;;;;GAMG;AACH,MAAM,WAAW,MAAM,CAAC,EAAE,SAAS,IAAI,EAAE,GAAG,SAAS,IAAI,GAAG,EAAE;IAE1D;;;;OAIG;IACH,OAAO,EAAE,CAAC,MAAM,EAAE,GAAG,GAAG,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,gBAAgB,EAAE;QAAE,CAAC,WAAW,EAAE,UAAU,GAAG,OAAO,CAAA;KAAE,KAAK,EAAE,CAAA;IAGzI;;;OAGG;IACH,eAAe,EAAE,CAAC,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;IAGrE;;OAEG;IACH,UAAU,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,OAAO,CAAA;CAEvD;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB,CAAC,EAAE,SAAS,IAAI,EAAE,GAAG,SAAS,IAAI,GAAG,EAAE,CAAE,SAAQ,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC;CAAG;AAGvG;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;AAqB3G;;;GAGG;AACH,eAAO,MAAM,uBAAuB,EAAE,eAAyC,CAAA;AAE/E;;;GAGG;AACH,eAAO,MAAM,sBAAsB,iBAAyB,CAAA"}

package/dist/writing.js

@@ -0,0 +1,30 @@
+import { Link } from "./m3/types.js";
+/**
+ * @return a {@link SettingsUpdater} that uses the given “meta key” – which is a property/key on the {@link Feature} type –
+ *  to look up what key to look a feature’s value up on a settings object.
+ *  <em>Note:</em> for internal use only — use with some care!
+ */
+const settingsUpdater = (metaKey) => (settings, feature, value) => {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const key = feature[metaKey];
+    if (feature instanceof Link && feature.multiple) {
+        if (!Array.isArray(settings[key])) {
+            settings[key] = [];
+        }
+        settings[key].push(value);
+    }
+    else {
+        settings[key] = value;
+    }
+};
+/**
+ * Updates the value of the given {@link Feature feature} on the given "settings" object
+ * (either a {@link Node node} or a sub object of it), using the feature's *name*.
+ */
+export const updateSettingsNameBased = settingsUpdater("name");
+/**
+ * Updates the value of the given {@link Feature feature} on the given "settings" object
+ * (either a {@link Node node} or a sub object of it), using the feature's *key*.
+ */
+export const updateSettingsKeyBased = settingsUpdater("key");
+//# sourceMappingURL=writing.js.map

package/dist/writing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writing.js","sourceRoot":"","sources":["../src/writing.ts"],"names":[],"mappings":"AAEA,OAAO,EAA2C,IAAI,EAAE,MAAM,eAAe,CAAA;AA8C7E;;;;GAIG;AACH,MAAM,eAAe,GAAG,CAAC,OAAsB,EAAmB,EAAE,CAChE,CAAC,QAAiC,EAAE,OAAgB,EAAE,KAAc,EAAQ,EAAE;IAClF,8DAA8D;IACtD,MAAM,GAAG,GAAI,OAAe,CAAC,OAAO,CAAW,CAAA;IAC/C,IAAI,OAAO,YAAY,IAAI,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QAC9C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YAChC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,CAAA;QACtB,CAAC;QACA,QAAQ,CAAC,GAAG,CAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAC5C,CAAC;SAAM,CAAC;QACJ,QAAQ,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;IACzB,CAAC;AACL,CAAC,CAAA;AAEL;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAoB,eAAe,CAAC,MAAM,CAAC,CAAA;AAE/E;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,eAAe,CAAC,KAAK,CAAC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lionweb/core",
-  "version": "0.7.0-alpha.5",
+  "version": "0.7.0-alpha.7",
   "description": "LionWeb core for {Java|Type}Script",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -27,7 +27,7 @@
     "release": "npm publish"
   },
   "dependencies": {
-    "@lionweb/json": "0.7.0-alpha.5",
-    "@lionweb/ts-utils": "0.7.0-alpha.5"
+    "@lionweb/json": "0.7.0-alpha.7",
+    "@lionweb/ts-utils": "0.7.0-alpha.7"
   }
 }

package/dist/facade.d.ts

@@ -1,85 +0,0 @@
-import { LionWebId, LionWebKey } from "@lionweb/json";
-import { Classifier, Enumeration, EnumerationLiteral, Feature } from "./m3/types.js";
-import { Node } from "./types.js";
-/**
- * Type def. for functions that deduce the {@link Classifier classifier} of a given {@link Node node}.
- */
-type ClassifierDeducer<NT extends Node> = (node: NT) => Classifier;
-/**
- * Type def. for functions that deduce the string value of the `resolveInfo` field of a
- * {@link LionWebJsonReferenceTarget serialized reference target}, or  {@code undefined}
- * to indicate that no `resolveInfo` could be derived.
- */
-type ResolveInfoDeducer<NT extends Node> = (node: NT) => string | undefined;
-/**
- * Two interfaces that defines façades for in-memory models.
- * Instances/implementations of this interface parametrize generic (de-)serialization.
- * Implementations of these interfaces {w|c}ould be:
- *  - specific to Lioncore (so to match m3/types.ts)
- *  - generic to deserialize into @link DynamicNode}
- */
-interface ExtractionFacade<NT extends Node> {
-    /**
-     * @return The {@link Concept concept} of the given node
-     */
-    classifierOf: ClassifierDeducer<NT>;
-    /**
-     * @return The value of the given {@link Feature feature} on the given node.
-     */
-    getFeatureValue: (node: NT, feature: Feature) => unknown;
-    /**
-     * @return The {@link EnumerationLiteral} corresponding to
-     * the given {@link Enumeration} and the runtime encoding of a literal of it,
-     */
-    enumerationLiteralFrom: (encoding: unknown, enumeration: Enumeration) => EnumerationLiteral | null;
-    /**
-     * @return The string value of the `resolveInfo` field of a {@link LionWebJsonReferenceTarget serialized reference target},
-     * or {@code undefined} to indicate that no `resolveInfo` could be derived.
-     */
-    resolveInfoFor?: ResolveInfoDeducer<NT>;
-}
-interface InstantiationFacade<NT extends Node, PNT extends Node = NT> {
-    /**
-     * @return An instance of the given concept, also given its parent (or {@link undefined} for root nodes),
-     * its ID and the values of the node's properties ("settings").
-     * (The latter may be required as arguments for the constructor of a class, whose instances represent nodes.)
-     */
-    nodeFor: (parent: PNT | undefined, classifier: Classifier, id: LionWebId, propertySettings: {
-        [propertyKey: LionWebKey]: unknown;
-    }) => NT;
-    /**
-     * Sets the *single* given value of the indicated {@link Feature} on the given node.
-     * This means adding it in case the feature is multi-valued, meaning it is a {@link Link} with {@code multiple = true}.
-     */
-    setFeatureValue: (node: NT, feature: Feature, value: unknown) => void;
-    /**
-     * @return The runtime encoding of the given {@link EnumerationLiteral}.
-     */
-    encodingOf: (literal: EnumerationLiteral) => unknown;
-}
-/**
- * Type def. for functions that extract {@link Node nodes} from a given one.
- */
-type NodesExtractor<NT extends Node> = (node: NT) => NT[];
-/**
- * @return A function that extracts the children from a given node.
- */
-declare const childrenExtractorUsing: <NT extends Node>(extractionFacade: ExtractionFacade<NT>) => NodesExtractor<NT>;
-/**
- * @return a function that extracts *all* nodes from a given start node - usually a root node.
- */
-declare const nodesExtractorUsing: <NT extends Node>(extractionFacade: ExtractionFacade<NT>) => NodesExtractor<NT>;
-type SettingsUpdater = (settings: Record<string, unknown>, feature: Feature, value: unknown) => void;
-/**
- * Updates the value of the given {@link Feature feature} on the given "settings" object
- * (either a {@link Node node} or a sub object of it), using the feature's *name*.
- */
-declare const updateSettingsNameBased: SettingsUpdater;
-/**
- * Updates the value of the given {@link Feature feature} on the given "settings" object
- * (either a {@link Node node} or a sub object of it), using the feature's *key*.
- */
-declare const updateSettingsKeyBased: SettingsUpdater;
-export type { ClassifierDeducer, ExtractionFacade, InstantiationFacade, NodesExtractor, ResolveInfoDeducer };
-export { childrenExtractorUsing, nodesExtractorUsing, updateSettingsKeyBased, updateSettingsNameBased };
-//# sourceMappingURL=facade.d.ts.map

package/dist/facade.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"facade.d.ts","sourceRoot":"","sources":["../src/facade.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAGrD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,kBAAkB,EAAE,OAAO,EAAQ,MAAM,eAAe,CAAA;AAC1F,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAGjC;;GAEG;AACH,KAAK,iBAAiB,CAAC,EAAE,SAAS,IAAI,IAAI,CAAC,IAAI,EAAE,EAAE,KAAK,UAAU,CAAA;AAElE;;;;GAIG;AACH,KAAK,kBAAkB,CAAC,EAAE,SAAS,IAAI,IAAI,CAAC,IAAI,EAAE,EAAE,KAAK,MAAM,GAAG,SAAS,CAAA;AAG3E;;;;;;GAMG;AAGH,UAAU,gBAAgB,CAAC,EAAE,SAAS,IAAI;IAEtC;;OAEG;IACH,YAAY,EAAE,iBAAiB,CAAC,EAAE,CAAC,CAAA;IAEnC;;OAEG;IACH,eAAe,EAAE,CAAC,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,KAAK,OAAO,CAAA;IAGxD;;;OAGG;IACH,sBAAsB,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,KAAK,kBAAkB,GAAG,IAAI,CAAA;IAElG;;;OAGG;IACH,cAAc,CAAC,EAAE,kBAAkB,CAAC,EAAE,CAAC,CAAA;CAE1C;AAED,UAAU,mBAAmB,CAAC,EAAE,SAAS,IAAI,EAAE,GAAG,SAAS,IAAI,GAAG,EAAE;IAEhE;;;;OAIG;IACH,OAAO,EAAE,CAAC,MAAM,EAAE,GAAG,GAAG,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,gBAAgB,EAAE;QAAE,CAAC,WAAW,EAAE,UAAU,GAAG,OAAO,CAAA;KAAE,KAAK,EAAE,CAAA;IAGzI;;;OAGG;IACH,eAAe,EAAE,CAAC,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;IAGrE;;OAEG;IACH,UAAU,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,OAAO,CAAA;CAEvD;AAED;;GAEG;AACH,KAAK,cAAc,CAAC,EAAE,SAAS,IAAI,IAAI,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,CAAA;AAEzD;;GAEG;AACH,QAAA,MAAM,sBAAsB,iFAOf,CAAA;AAGb;;GAEG;AACH,QAAA,MAAM,mBAAmB,iFACsE,CAAA;AAG/F,KAAK,eAAe,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;AAiBpG;;;GAGG;AACH,QAAA,MAAM,uBAAuB,EAAE,eAAyC,CAAA;AAExE;;;GAGG;AACH,QAAA,MAAM,sBAAsB,iBAAyB,CAAA;AAErD,YAAY,EACR,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EACrB,CAAA;AAED,OAAO,EACH,sBAAsB,EACtB,mBAAmB,EACnB,sBAAsB,EACtB,uBAAuB,EAC1B,CAAA"}

package/dist/facade.js

@@ -1,42 +0,0 @@
-import { flatMapNonCyclingFollowing, trivialFlatMapper } from "@lionweb/ts-utils";
-import { allFeaturesOf, isContainment } from "./m3/functions.js";
-import { Link } from "./m3/types.js";
-/**
- * @return A function that extracts the children from a given node.
- */
-const childrenExtractorUsing = (extractionFacade) => (node) => [
-    ...(allFeaturesOf(extractionFacade.classifierOf(node))
-        .filter(isContainment)
-        .flatMap((containment) => extractionFacade.getFeatureValue(node, containment) ?? [])),
-    // FIXME  there's NO guarantee about the result of extractionFacade.getFeatureValue(node, containment) !!!
-    ...node.annotations
-];
-/**
- * @return a function that extracts *all* nodes from a given start node - usually a root node.
- */
-const nodesExtractorUsing = (extractionFacade) => flatMapNonCyclingFollowing(trivialFlatMapper, childrenExtractorUsing(extractionFacade));
-const settingsUpdater = (metaKey) => (settings, feature, value) => {
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const key = feature[metaKey];
-    if (feature instanceof Link && feature.multiple) {
-        if (!Array.isArray(settings[key])) {
-            settings[key] = [];
-        }
-        settings[key].push(value);
-    }
-    else {
-        settings[key] = value;
-    }
-};
-/**
- * Updates the value of the given {@link Feature feature} on the given "settings" object
- * (either a {@link Node node} or a sub object of it), using the feature's *name*.
- */
-const updateSettingsNameBased = settingsUpdater("name");
-/**
- * Updates the value of the given {@link Feature feature} on the given "settings" object
- * (either a {@link Node node} or a sub object of it), using the feature's *key*.
- */
-const updateSettingsKeyBased = settingsUpdater("key");
-export { childrenExtractorUsing, nodesExtractorUsing, updateSettingsKeyBased, updateSettingsNameBased };
-//# sourceMappingURL=facade.js.map

package/dist/facade.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"facade.js","sourceRoot":"","sources":["../src/facade.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,0BAA0B,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AACjF,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAChE,OAAO,EAAwD,IAAI,EAAE,MAAM,eAAe,CAAA;AAkF1F;;GAEG;AACH,MAAM,sBAAsB,GAAG,CAAkB,gBAAsC,EAAsB,EAAE,CAC3G,CAAC,IAAQ,EAAQ,EAAE,CAAC;IAChB,GAAG,CAAC,aAAa,CAAC,gBAAgB,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;SACjD,MAAM,CAAC,aAAa,CAAC;SACrB,OAAO,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,gBAAgB,CAAC,eAAe,CAAC,IAAI,EAAE,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;IACjG,0GAA0G;IAClG,GAAG,IAAI,CAAC,WAAW;CACd,CAAA;AAGb;;GAEG;AACH,MAAM,mBAAmB,GAAG,CAAkB,gBAAsC,EAAsB,EAAE,CACxG,0BAA0B,CAAC,iBAAiB,EAAE,sBAAsB,CAAK,gBAAgB,CAAC,CAAC,CAAA;AAK/F,MAAM,eAAe,GAAG,CAAC,OAAsB,EAAmB,EAAE,CAChE,CAAC,QAAiC,EAAE,OAAgB,EAAE,KAAc,EAAQ,EAAE;IAClF,8DAA8D;IACtD,MAAM,GAAG,GAAI,OAAe,CAAC,OAAO,CAAW,CAAA;IAC/C,IAAI,OAAO,YAAY,IAAI,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QAC9C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YAChC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,CAAA;QACtB,CAAC;QACA,QAAQ,CAAC,GAAG,CAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAC5C,CAAC;SAAM,CAAC;QACJ,QAAQ,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;IACzB,CAAC;AACL,CAAC,CAAA;AAGL;;;GAGG;AACH,MAAM,uBAAuB,GAAoB,eAAe,CAAC,MAAM,CAAC,CAAA;AAExE;;;GAGG;AACH,MAAM,sBAAsB,GAAG,eAAe,CAAC,KAAK,CAAC,CAAA;AAUrD,OAAO,EACH,sBAAsB,EACtB,mBAAmB,EACnB,sBAAsB,EACtB,uBAAuB,EAC1B,CAAA"}