@lionweb/class-core 0.6.13-beta.0

package/dist/deltas/types.g.js

@@ -0,0 +1,180 @@
+// Copyright 2025 TRUMPF Laser SE and other contributors
+//
+// 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.
+//
+// SPDX-FileCopyrightText: 2025 TRUMPF Laser SE and other contributors
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Delta that does nothing.
+ * Warning: should only be used for development purposes!
+ */
+export class NoOpDelta {
+}
+export class PropertyAddedDelta {
+    constructor(container, property, value) {
+        this.container = container;
+        this.property = property;
+        this.value = value;
+    }
+}
+export class PropertyDeletedDelta {
+    constructor(container, property, oldValue) {
+        this.container = container;
+        this.property = property;
+        this.oldValue = oldValue;
+    }
+}
+export class PropertyChangedDelta {
+    constructor(container, property, oldValue, newValue) {
+        this.container = container;
+        this.property = property;
+        this.oldValue = oldValue;
+        this.newValue = newValue;
+    }
+}
+export class ChildAddedDelta {
+    constructor(parent, containment, index, newChild) {
+        this.parent = parent;
+        this.containment = containment;
+        this.index = index;
+        this.newChild = newChild;
+    }
+}
+export class ChildDeletedDelta {
+    constructor(parent, containment, index, deletedChild) {
+        this.parent = parent;
+        this.containment = containment;
+        this.index = index;
+        this.deletedChild = deletedChild;
+    }
+}
+export class ChildReplacedDelta {
+    constructor(parent, containment, index, replacedChild, newChild) {
+        this.parent = parent;
+        this.containment = containment;
+        this.index = index;
+        this.replacedChild = replacedChild;
+        this.newChild = newChild;
+    }
+}
+export class ChildMovedDelta {
+    constructor(oldParent, oldContainment, oldIndex, newParent, newContainment, newIndex, child) {
+        this.oldParent = oldParent;
+        this.oldContainment = oldContainment;
+        this.oldIndex = oldIndex;
+        this.newParent = newParent;
+        this.newContainment = newContainment;
+        this.newIndex = newIndex;
+        this.child = child;
+    }
+}
+export class ChildMovedInSameContainmentDelta {
+    constructor(parent, containment, oldIndex, newIndex, child) {
+        this.parent = parent;
+        this.containment = containment;
+        this.oldIndex = oldIndex;
+        this.newIndex = newIndex;
+        this.child = child;
+    }
+}
+export class ReferenceAddedDelta {
+    constructor(container, reference, index, newTarget) {
+        this.container = container;
+        this.reference = reference;
+        this.index = index;
+        this.newTarget = newTarget;
+    }
+}
+export class ReferenceDeletedDelta {
+    constructor(container, reference, index, deletedTarget) {
+        this.container = container;
+        this.reference = reference;
+        this.index = index;
+        this.deletedTarget = deletedTarget;
+    }
+}
+/**
+ * Note: corresponds to "reference changed" in delta proposal!
+ */
+export class ReferenceReplacedDelta {
+    constructor(container, reference, index, replacedTarget, newTarget) {
+        this.container = container;
+        this.reference = reference;
+        this.index = index;
+        this.replacedTarget = replacedTarget;
+        this.newTarget = newTarget;
+    }
+}
+/**
+ * Note: corresponds to "entry moved from other reference" in delta proposal!
+ */
+export class ReferenceMovedDelta {
+    constructor(oldContainer, oldReference, oldIndex, newContainer, newReference, newIndex, target) {
+        this.oldContainer = oldContainer;
+        this.oldReference = oldReference;
+        this.oldIndex = oldIndex;
+        this.newContainer = newContainer;
+        this.newReference = newReference;
+        this.newIndex = newIndex;
+        this.target = target;
+    }
+}
+export class ReferenceMovedInSameReferenceDelta {
+    constructor(container, reference, oldIndex, newIndex, target) {
+        this.container = container;
+        this.reference = reference;
+        this.oldIndex = oldIndex;
+        this.newIndex = newIndex;
+        this.target = target;
+    }
+}
+export class AnnotationAddedDelta {
+    constructor(parent, index, newAnnotation) {
+        this.parent = parent;
+        this.index = index;
+        this.newAnnotation = newAnnotation;
+    }
+}
+export class AnnotationDeletedDelta {
+    constructor(parent, index, deletedAnnotation) {
+        this.parent = parent;
+        this.index = index;
+        this.deletedAnnotation = deletedAnnotation;
+    }
+}
+export class AnnotationReplacedDelta {
+    constructor(parent, index, replacedAnnotation, newAnnotation) {
+        this.parent = parent;
+        this.index = index;
+        this.replacedAnnotation = replacedAnnotation;
+        this.newAnnotation = newAnnotation;
+    }
+}
+export class AnnotationMovedFromOtherParentDelta {
+    constructor(oldParent, oldIndex, newParent, newIndex, movedAnnotation) {
+        this.oldParent = oldParent;
+        this.oldIndex = oldIndex;
+        this.newParent = newParent;
+        this.newIndex = newIndex;
+        this.movedAnnotation = movedAnnotation;
+    }
+}
+export class AnnotationMovedInSameParentDelta {
+    constructor(parent, oldIndex, newIndex, movedAnnotation) {
+        this.parent = parent;
+        this.oldIndex = oldIndex;
+        this.newIndex = newIndex;
+        this.movedAnnotation = movedAnnotation;
+    }
+}
+//# sourceMappingURL=types.g.js.map

package/dist/deltas/types.g.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.g.js","sourceRoot":"","sources":["../../src/deltas/types.g.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,EAAE;AACF,iEAAiE;AACjE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,EAAE;AACF,sEAAsE;AACtE,sCAAsC;AAgBtC;;;GAGG;AACH,MAAM,OAAO,SAAS;CACrB;AAED,MAAM,OAAO,kBAAkB;IAC3B,YACoB,SAAoB,EACpB,QAAkB,EAClB,KAAQ;QAFR,cAAS,GAAT,SAAS,CAAW;QACpB,aAAQ,GAAR,QAAQ,CAAU;QAClB,UAAK,GAAL,KAAK,CAAG;IAE5B,CAAC;CACJ;AAED,MAAM,OAAO,oBAAoB;IAC7B,YACoB,SAAoB,EACpB,QAAkB,EAClB,QAAW;QAFX,cAAS,GAAT,SAAS,CAAW;QACpB,aAAQ,GAAR,QAAQ,CAAU;QAClB,aAAQ,GAAR,QAAQ,CAAG;IAE/B,CAAC;CACJ;AAED,MAAM,OAAO,oBAAoB;IAC7B,YACoB,SAAoB,EACpB,QAAkB,EAClB,QAAW,EACX,QAAW;QAHX,cAAS,GAAT,SAAS,CAAW;QACpB,aAAQ,GAAR,QAAQ,CAAU;QAClB,aAAQ,GAAR,QAAQ,CAAG;QACX,aAAQ,GAAR,QAAQ,CAAG;IAE/B,CAAC;CACJ;AAED,MAAM,OAAO,eAAe;IACxB,YACoB,MAAiB,EACjB,WAAwB,EACxB,KAAa,EACb,QAAmB;QAHnB,WAAM,GAAN,MAAM,CAAW;QACjB,gBAAW,GAAX,WAAW,CAAa;QACxB,UAAK,GAAL,KAAK,CAAQ;QACb,aAAQ,GAAR,QAAQ,CAAW;IAEvC,CAAC;CACJ;AAED,MAAM,OAAO,iBAAiB;IAC1B,YACoB,MAAiB,EACjB,WAAwB,EACxB,KAAa,EACb,YAAuB;QAHvB,WAAM,GAAN,MAAM,CAAW;QACjB,gBAAW,GAAX,WAAW,CAAa;QACxB,UAAK,GAAL,KAAK,CAAQ;QACb,iBAAY,GAAZ,YAAY,CAAW;IAE3C,CAAC;CACJ;AAED,MAAM,OAAO,kBAAkB;IAC3B,YACoB,MAAiB,EACjB,WAAwB,EACxB,KAAa,EACb,aAAwB,EACxB,QAAmB;QAJnB,WAAM,GAAN,MAAM,CAAW;QACjB,gBAAW,GAAX,WAAW,CAAa;QACxB,UAAK,GAAL,KAAK,CAAQ;QACb,kBAAa,GAAb,aAAa,CAAW;QACxB,aAAQ,GAAR,QAAQ,CAAW;IAEvC,CAAC;CACJ;AAED,MAAM,OAAO,eAAe;IACxB,YACoB,SAAoB,EACpB,cAA2B,EAC3B,QAAgB,EAChB,SAAoB,EACpB,cAA2B,EAC3B,QAAgB,EAChB,KAAgB;QANhB,cAAS,GAAT,SAAS,CAAW;QACpB,mBAAc,GAAd,cAAc,CAAa;QAC3B,aAAQ,GAAR,QAAQ,CAAQ;QAChB,cAAS,GAAT,SAAS,CAAW;QACpB,mBAAc,GAAd,cAAc,CAAa;QAC3B,aAAQ,GAAR,QAAQ,CAAQ;QAChB,UAAK,GAAL,KAAK,CAAW;IAEpC,CAAC;CACJ;AAED,MAAM,OAAO,gCAAgC;IACzC,YACoB,MAAiB,EACjB,WAAwB,EACxB,QAAgB,EAChB,QAAgB,EAChB,KAAgB;QAJhB,WAAM,GAAN,MAAM,CAAW;QACjB,gBAAW,GAAX,WAAW,CAAa;QACxB,aAAQ,GAAR,QAAQ,CAAQ;QAChB,aAAQ,GAAR,QAAQ,CAAQ;QAChB,UAAK,GAAL,KAAK,CAAW;IAEpC,CAAC;CACJ;AAED,MAAM,OAAO,mBAAmB;IAC5B,YACoB,SAAoB,EACpB,SAAoB,EACpB,KAAa,EACb,SAA+B;QAH/B,cAAS,GAAT,SAAS,CAAW;QACpB,cAAS,GAAT,SAAS,CAAW;QACpB,UAAK,GAAL,KAAK,CAAQ;QACb,cAAS,GAAT,SAAS,CAAsB;IAEnD,CAAC;CACJ;AAED,MAAM,OAAO,qBAAqB;IAC9B,YACoB,SAAoB,EACpB,SAAoB,EACpB,KAAa,EACb,aAAmC;QAHnC,cAAS,GAAT,SAAS,CAAW;QACpB,cAAS,GAAT,SAAS,CAAW;QACpB,UAAK,GAAL,KAAK,CAAQ;QACb,kBAAa,GAAb,aAAa,CAAsB;IAEvD,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,OAAO,sBAAsB;IAC/B,YACoB,SAAoB,EACpB,SAAoB,EACpB,KAAa,EACb,cAAoC,EACpC,SAA+B;QAJ/B,cAAS,GAAT,SAAS,CAAW;QACpB,cAAS,GAAT,SAAS,CAAW;QACpB,UAAK,GAAL,KAAK,CAAQ;QACb,mBAAc,GAAd,cAAc,CAAsB;QACpC,cAAS,GAAT,SAAS,CAAsB;IAEnD,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,OAAO,mBAAmB;IAC5B,YACoB,YAAuB,EACvB,YAAuB,EACvB,QAAgB,EAChB,YAAuB,EACvB,YAAuB,EACvB,QAAgB,EAChB,MAA4B;QAN5B,iBAAY,GAAZ,YAAY,CAAW;QACvB,iBAAY,GAAZ,YAAY,CAAW;QACvB,aAAQ,GAAR,QAAQ,CAAQ;QAChB,iBAAY,GAAZ,YAAY,CAAW;QACvB,iBAAY,GAAZ,YAAY,CAAW;QACvB,aAAQ,GAAR,QAAQ,CAAQ;QAChB,WAAM,GAAN,MAAM,CAAsB;IAEhD,CAAC;CACJ;AAED,MAAM,OAAO,kCAAkC;IAC3C,YACoB,SAAoB,EACpB,SAAoB,EACpB,QAAgB,EAChB,QAAgB,EAChB,MAA4B;QAJ5B,cAAS,GAAT,SAAS,CAAW;QACpB,cAAS,GAAT,SAAS,CAAW;QACpB,aAAQ,GAAR,QAAQ,CAAQ;QAChB,aAAQ,GAAR,QAAQ,CAAQ;QAChB,WAAM,GAAN,MAAM,CAAsB;IAEhD,CAAC;CACJ;AAED,MAAM,OAAO,oBAAoB;IAC7B,YACoB,MAAiB,EACjB,KAAa,EACb,aAAwB;QAFxB,WAAM,GAAN,MAAM,CAAW;QACjB,UAAK,GAAL,KAAK,CAAQ;QACb,kBAAa,GAAb,aAAa,CAAW;IAE5C,CAAC;CACJ;AAED,MAAM,OAAO,sBAAsB;IAC/B,YACoB,MAAiB,EACjB,KAAa,EACb,iBAA4B;QAF5B,WAAM,GAAN,MAAM,CAAW;QACjB,UAAK,GAAL,KAAK,CAAQ;QACb,sBAAiB,GAAjB,iBAAiB,CAAW;IAEhD,CAAC;CACJ;AAED,MAAM,OAAO,uBAAuB;IAChC,YACoB,MAAiB,EACjB,KAAa,EACb,kBAA6B,EAC7B,aAAwB;QAHxB,WAAM,GAAN,MAAM,CAAW;QACjB,UAAK,GAAL,KAAK,CAAQ;QACb,uBAAkB,GAAlB,kBAAkB,CAAW;QAC7B,kBAAa,GAAb,aAAa,CAAW;IAE5C,CAAC;CACJ;AAED,MAAM,OAAO,mCAAmC;IAC5C,YACoB,SAAoB,EACpB,QAAgB,EAChB,SAAoB,EACpB,QAAgB,EAChB,eAA0B;QAJ1B,cAAS,GAAT,SAAS,CAAW;QACpB,aAAQ,GAAR,QAAQ,CAAQ;QAChB,cAAS,GAAT,SAAS,CAAW;QACpB,aAAQ,GAAR,QAAQ,CAAQ;QAChB,oBAAe,GAAf,eAAe,CAAW;IAE9C,CAAC;CACJ;AAED,MAAM,OAAO,gCAAgC;IACzC,YACoB,MAAiB,EACjB,QAAgB,EAChB,QAAgB,EAChB,eAA0B;QAH1B,WAAM,GAAN,MAAM,CAAW;QACjB,aAAQ,GAAR,QAAQ,CAAQ;QAChB,aAAQ,GAAR,QAAQ,CAAQ;QAChB,oBAAe,GAAf,eAAe,CAAW;IAE9C,CAAC;CACJ"}

package/dist/deserializer.d.ts

@@ -0,0 +1,27 @@
+import { PrimitiveTypeDeserializer, SerializationChunk, SimplisticHandler } from "@lionweb/core";
+import { DeltaHandler, IdMapping, ILanguageBase, INodeBase } from "./index.js";
+/**
+ * A type for deserializer functions that are parametrized in their return type.
+ */
+export type Deserializer<T> = (serializationChunk: SerializationChunk, dependentNodes?: INodeBase[], primitiveTypeDeserializer?: PrimitiveTypeDeserializer, problemHandler?: SimplisticHandler) => T;
+/**
+ * A quasi-tuple of the roots (of type {@link INodeBase}) of a model,
+ * and its {@link IdMapping} instance.
+ */
+export type RootsWithIdMapping = {
+    roots: INodeBase[];
+    idMapping: IdMapping;
+};
+/**
+ * @return a {@link Deserializer} function for the given languages (given as {@link ILanguageBase}s) that returns a {@link RootsWithIdMapping}.
+ * @param languageBases the {@link ILanguageBase}s for (at least) all the languages used in the {@link SerializationChunk} to deserialize, minus LionCore M3 and built-ins.
+ * @param handleDelta an optional {@link DeltaHandler} that will be injected in all {@link INodeBase nodes} created.
+ */
+export declare const nodeBaseDeserializerWithIdMapping: (languageBases: ILanguageBase[], handleDelta?: DeltaHandler) => Deserializer<RootsWithIdMapping>;
+/**
+ * @return a {@link Deserializer} function for the languages (given as {@link ILanguageBase}s) that returns the roots (of type {@link INodeBase}) of the deserialized model.
+ * @param languageBases the {@link ILanguageBase}s for (at least) all the languages used in the {@link SerializationChunk} to deserialize, minus LionCore M3 and built-ins.
+ * @param handleDelta an optional {@link DeltaHandler} that will be injected in all {@link INodeBase nodes} created.
+ */
+export declare const nodeBaseDeserializer: (languageBases: ILanguageBase[], handleDelta?: DeltaHandler) => Deserializer<INodeBase[]>;
+//# sourceMappingURL=deserializer.d.ts.map

package/dist/deserializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deserializer.d.ts","sourceRoot":"","sources":["../src/deserializer.ts"],"names":[],"mappings":"AAiBA,OAAO,EAWH,yBAAyB,EAGzB,kBAAkB,EAElB,iBAAiB,EAEpB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAC,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,EAAC,MAAM,YAAY,CAAC;AAI7E;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAC1B,kBAAkB,EAAE,kBAAkB,EACtC,cAAc,CAAC,EAAE,SAAS,EAAE,EAC5B,yBAAyB,CAAC,EAAE,yBAAyB,EACrD,cAAc,CAAC,EAAE,iBAAiB,KACjC,CAAC,CAAC;AAkBP;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IAAC,SAAS,EAAE,SAAS,CAAA;CAAE,CAAC;AAG9E;;;;GAIG;AACH,eAAO,MAAM,iCAAiC,kBAAmB,aAAa,EAAE,gBAAgB,YAAY,KAAG,aAAa,kBAAkB,CAwI7I,CAAC;AAGF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,kBAAmB,aAAa,EAAE,gBAAgB,YAAY,KAAG,aAAa,SAAS,EAAE,CASzH,CAAA"}

package/dist/deserializer.js

@@ -0,0 +1,168 @@
+// Copyright 2025 TRUMPF Laser SE and other contributors
+//
+// 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.
+//
+// SPDX-FileCopyrightText: 2025 TRUMPF Laser SE and other contributors
+// SPDX-License-Identifier: Apache-2.0
+import { byIdMap, Classifier, Containment, DefaultPrimitiveTypeDeserializer, defaultSimplisticHandler, Enumeration, MemoisingSymbolTable, PrimitiveType, Property, Reference, unresolved } from "@lionweb/core";
+import { IdMapping } from "./index.js";
+const languageBaseLookupFor = (languageBases) => (language) => {
+    const languageBase = languageBases.find((languageBase) => languageBase.language === language);
+    if (languageBase === undefined) {
+        throw new Error(`language ${language.name} (with key=${language.key} and version=${language.version}) not known`);
+    }
+    return languageBase;
+};
+const factoryLookupFor = (languageBases, handleDelta) => {
+    const lookup = languageBaseLookupFor(languageBases);
+    return (language) => lookup(language).factory(handleDelta);
+};
+/**
+ * @return a {@link Deserializer} function for the given languages (given as {@link ILanguageBase}s) that returns a {@link RootsWithIdMapping}.
+ * @param languageBases the {@link ILanguageBase}s for (at least) all the languages used in the {@link SerializationChunk} to deserialize, minus LionCore M3 and built-ins.
+ * @param handleDelta an optional {@link DeltaHandler} that will be injected in all {@link INodeBase nodes} created.
+ */
+export const nodeBaseDeserializerWithIdMapping = (languageBases, handleDelta) => {
+    const symbolTable = new MemoisingSymbolTable(languageBases.map(({ language }) => language));
+    const languageBaseFor = languageBaseLookupFor(languageBases);
+    const factoryFor = factoryLookupFor(languageBases, handleDelta);
+    return (serializationChunk, dependentNodes = [], primitiveTypeDeserializer = new DefaultPrimitiveTypeDeserializer(), problemsHandler = defaultSimplisticHandler) => {
+        const nodesToInstall = [];
+        const createNode = ({ id, classifier: classifierMetaPointer, properties, containments, references, annotations }) => {
+            const languageMessage = `language ${classifierMetaPointer.language} (${classifierMetaPointer.version})`;
+            const classifier = symbolTable.entityMatching(classifierMetaPointer);
+            if (classifier === undefined || !(classifier instanceof Classifier)) {
+                problemsHandler.reportProblem(`can't deserialize node with id=${id}: can't find the classifier with key ${classifierMetaPointer.key} in ${languageMessage} - skipping`);
+                return undefined;
+            }
+            const node = factoryFor(classifier.language)(classifier, id);
+            properties.forEach(({ property: propertyMetaPointer, value }) => {
+                const feature = symbolTable.featureMatching(classifierMetaPointer, propertyMetaPointer);
+                if (feature === undefined) {
+                    problemsHandler.reportProblem(`can't deserialize value for feature with key ${propertyMetaPointer.key} in ${languageMessage}: feature not found on classifier ${classifierMetaPointer.key} in language (${classifierMetaPointer.language}, ${classifierMetaPointer.version}) - skipping`);
+                }
+                else if (feature instanceof Property) {
+                    if (feature.type instanceof PrimitiveType) {
+                        node.getPropertyValueManager(feature).setDirectly(value === null ? undefined : primitiveTypeDeserializer.deserializeValue(value, feature));
+                    }
+                    else if (feature.type instanceof Enumeration) {
+                        if (value !== undefined) {
+                            const literal = feature.type.literals.find((literal) => literal.key === value);
+                            if (literal === undefined) {
+                                problemsHandler.reportProblem(`can't deserialize literal encoded as: ${value}`);
+                            }
+                            else {
+                                node.getPropertyValueManager(feature).setDirectly(languageBaseFor(feature.type.language).enumLiteralFrom(literal));
+                            }
+                        }
+                    }
+                }
+                else {
+                    problemsHandler.reportProblem(`can't deserialize value for feature with key ${propertyMetaPointer.key} in ${languageMessage}: feature is not a property - skipping`);
+                }
+            });
+            containments.forEach(({ containment: containmentMetaPointer, children }) => {
+                const feature = symbolTable.featureMatching(classifierMetaPointer, containmentMetaPointer);
+                if (feature === undefined) {
+                    problemsHandler.reportProblem(`can't deserialize value for feature with key ${containmentMetaPointer.key} in ${languageMessage}: feature not found on classifier ${classifierMetaPointer.key} in language (${classifierMetaPointer.language}, ${classifierMetaPointer.version}) - skipping`);
+                }
+                else if (feature instanceof Containment) {
+                    nodesToInstall.push([node, feature, children]);
+                }
+                else {
+                    problemsHandler.reportProblem(`can't deserialize value for feature with key ${containmentMetaPointer.key} in ${languageMessage}: feature is not a containment - skipping`);
+                }
+            });
+            references.forEach(({ reference: referenceMetaPointer, targets }) => {
+                const feature = symbolTable.featureMatching(classifierMetaPointer, referenceMetaPointer);
+                if (feature === undefined) {
+                    problemsHandler.reportProblem(`can't deserialize value for feature with key ${referenceMetaPointer.key} in ${languageMessage}: feature not found on classifier ${classifierMetaPointer.key} in language (${classifierMetaPointer.language}, ${classifierMetaPointer.version}) - skipping`);
+                }
+                else if (feature instanceof Reference) {
+                    nodesToInstall.push([node, feature, targets.map(({ reference }) => reference)]);
+                }
+                else {
+                    problemsHandler.reportProblem(`can't deserialize value for feature with key ${referenceMetaPointer.key} in ${languageMessage}: feature is not a reference - skipping`);
+                }
+            });
+            if (annotations.length > 0) {
+                nodesToInstall.push([node, null, annotations]);
+            }
+            return node;
+        };
+        const nodesById = byIdMap(serializationChunk.nodes
+            .map(createNode)
+            .filter((nodeOrUndef) => nodeOrUndef !== undefined));
+        const dependentNodesById = byIdMap(dependentNodes);
+        const lookupNodeById = (id) => nodesById[id] ?? dependentNodesById[id];
+        nodesToInstall.forEach(([node, feature, ids]) => {
+            if (feature instanceof Containment) {
+                const valueManager = node.getContainmentValueManager(feature);
+                ids.forEach((id) => {
+                    const nodeToInstall = lookupNodeById(id);
+                    if (nodeToInstall === undefined) {
+                        problemsHandler.reportProblem(`couldn't resolve the child with id=${id} of the "${feature.name}" containment feature on the node with id=${node.id}`);
+                    }
+                    else {
+                        valueManager.addDirectly(nodeToInstall);
+                        nodeToInstall.attachTo(node, feature);
+                    }
+                });
+                return;
+            }
+            if (feature instanceof Reference) {
+                const valueManager = node.getReferenceValueManager(feature);
+                ids.forEach((id) => {
+                    const nodeToInstall = lookupNodeById(id);
+                    if (nodeToInstall === undefined) {
+                        problemsHandler.reportProblem(`couldn't resolve the target with id=${id} of the "${feature.name}" reference feature on the node with id=${node.id}`);
+                        valueManager.addDirectly(unresolved);
+                    }
+                    else {
+                        valueManager.addDirectly(nodeToInstall);
+                    }
+                });
+                return;
+            }
+            if (feature === null) {
+                const valueManager = node.annotationsValueManager;
+                ids.forEach((id) => {
+                    const nodeToInstall = lookupNodeById(id);
+                    if (nodeToInstall === undefined) {
+                        problemsHandler.reportProblem(`couldn't resolve the annotation with id=${id} on the node with id=${node.id}`);
+                    }
+                    else {
+                        valueManager.addDirectly(nodeToInstall);
+                        nodeToInstall.attachTo(node, feature);
+                    }
+                });
+                return;
+            }
+        });
+        return {
+            roots: Object.values(nodesById)
+                .filter(({ parent }) => parent === undefined),
+            idMapping: new IdMapping({ ...nodesById, ...dependentNodesById })
+        };
+    };
+};
+/**
+ * @return a {@link Deserializer} function for the languages (given as {@link ILanguageBase}s) that returns the roots (of type {@link INodeBase}) of the deserialized model.
+ * @param languageBases the {@link ILanguageBase}s for (at least) all the languages used in the {@link SerializationChunk} to deserialize, minus LionCore M3 and built-ins.
+ * @param handleDelta an optional {@link DeltaHandler} that will be injected in all {@link INodeBase nodes} created.
+ */
+export const nodeBaseDeserializer = (languageBases, handleDelta) => {
+    const deserializerWithIdMapping = nodeBaseDeserializerWithIdMapping(languageBases, handleDelta);
+    return (serializationChunk, dependentNodes = [], primitiveTypeDeserializer = new DefaultPrimitiveTypeDeserializer(), problemsHandler = defaultSimplisticHandler) => deserializerWithIdMapping(serializationChunk, dependentNodes, primitiveTypeDeserializer, problemsHandler).roots;
+};
+//# sourceMappingURL=deserializer.js.map

package/dist/deserializer.js.map

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

package/dist/duplicator.d.ts

@@ -0,0 +1,19 @@
+import { Feature } from "@lionweb/core";
+import { INodeBase } from "./base-types.js";
+/**
+ * Type definition for functions that duplicate a node.
+ */
+export type NodeDuplicator = (originalNode: INodeBase) => [duplicatedNode: INodeBase, featuresToDuplicate: Feature[]];
+/**
+ * Type definition for functions that duplicate the (variadically) given nodes.
+ */
+export type Duplicator = (...nodes: INodeBase[]) => INodeBase[];
+/**
+ * @return a function that deep-duplicates a given forest of {@link INodeBase nodes}.
+ * The result is an array of the deep-duplicated versions of the given nodes *in the same order*.
+ *
+ *  @param duplicateNode a function that returns a – possibly transformed – duplicate of the passed `originalNode`.
+ * ***Note***: it's assumed that the classifiers of the original and duplicated nodes coincide exactly!
+ */
+export declare const deepDuplicateWith: (duplicateNode: NodeDuplicator) => Duplicator;
+//# sourceMappingURL=duplicator.d.ts.map

package/dist/duplicator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duplicator.d.ts","sourceRoot":"","sources":["../src/duplicator.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAuB,OAAO,EAA6D,MAAM,eAAe,CAAC;AAExH,OAAO,EAAC,SAAS,EAAC,MAAM,iBAAiB,CAAC;AAM1C;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,YAAY,EAAE,SAAS,KAAK,CAAC,cAAc,EAAE,SAAS,EAAE,mBAAmB,EAAE,OAAO,EAAE,CAAC,CAAC;AAEtH;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,GAAG,KAAK,EAAE,SAAS,EAAE,KAAK,SAAS,EAAE,CAAC;AAEhE;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,kBAAmB,cAAc,KAAG,UAmE7D,CAAC"}

package/dist/duplicator.js

@@ -0,0 +1,87 @@
+// Copyright 2025 TRUMPF Laser SE and other contributors
+//
+// 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.
+//
+// SPDX-FileCopyrightText: 2025 TRUMPF Laser SE and other contributors
+// SPDX-License-Identifier: Apache-2.0
+import { asArray, Containment, idOf, Link, Property, Reference, unresolved } from "@lionweb/core";
+import { getFeatureValue } from "./serializer.js";
+import { allNodesFrom } from "./convenience.js";
+/**
+ * @return a function that deep-duplicates a given forest of {@link INodeBase nodes}.
+ * The result is an array of the deep-duplicated versions of the given nodes *in the same order*.
+ *
+ *  @param duplicateNode a function that returns a – possibly transformed – duplicate of the passed `originalNode`.
+ * ***Note***: it's assumed that the classifiers of the original and duplicated nodes coincide exactly!
+ */
+export const deepDuplicateWith = (duplicateNode) => (...nodes) => {
+    const nodesToInstall = [];
+    const visit = (node) => {
+        const [duplicatedNode, featuresToDuplicate] = duplicateNode(node);
+        const duplicateFeatureValue = (feature) => {
+            const value = getFeatureValue(node, feature);
+            if (feature instanceof Property) {
+                duplicatedNode.getPropertyValueManager(feature).setDirectly(value);
+            }
+            else if (feature instanceof Link) {
+                const values = asArray(value);
+                const resolvedValues = values.filter((value) => value !== unresolved);
+                if (resolvedValues.length > 0) {
+                    nodesToInstall.push([
+                        duplicatedNode,
+                        feature,
+                        resolvedValues.map(idOf),
+                        feature instanceof Reference
+                            ? resolvedValues
+                            : undefined
+                    ]);
+                }
+            }
+        };
+        featuresToDuplicate.forEach(duplicateFeatureValue);
+        if (node.annotations.length > 0) {
+            nodesToInstall.push([duplicatedNode, null, node.annotations.map(idOf)]);
+        }
+        return [node.id, duplicatedNode];
+    };
+    const duplicatedNodesByOriginalId = Object.fromEntries(nodes.flatMap(allNodesFrom).map(visit));
+    nodesToInstall.forEach(([copiedNode, feature, ids, originalReferenceTargets]) => {
+        if (feature instanceof Containment) {
+            const valueManager = copiedNode.getContainmentValueManager(feature);
+            ids.forEach((id) => {
+                const nodeToInstall = duplicatedNodesByOriginalId[id];
+                valueManager.addDirectly(nodeToInstall);
+                nodeToInstall.attachTo(copiedNode, feature);
+            });
+            return;
+        }
+        if (feature instanceof Reference) {
+            const valueManager = copiedNode.getReferenceValueManager(feature);
+            ids.forEach((id, index) => {
+                const nodeToInstall = duplicatedNodesByOriginalId[id] ?? originalReferenceTargets[index];
+                valueManager.addDirectly(nodeToInstall);
+            });
+            return;
+        }
+        if (feature === null) {
+            const valueManager = copiedNode.annotationsValueManager;
+            ids.forEach((id) => {
+                const nodeToInstall = duplicatedNodesByOriginalId[id];
+                valueManager.addDirectly(nodeToInstall);
+            });
+            return;
+        }
+    });
+    return nodes.map(({ id }) => duplicatedNodesByOriginalId[id]);
+};
+//# sourceMappingURL=duplicator.js.map

package/dist/duplicator.js.map

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

package/dist/id-mapping.d.ts

@@ -0,0 +1,19 @@
+import { Id, IdOrUnresolved, SingleRef } from "@lionweb/core";
+import { INodeBase } from "./index.js";
+type NodesById = {
+    [id: Id]: INodeBase;
+};
+/**
+ * Maintains a mapping ID → node,
+ * which is primarily used for efficiently applying {@link IDelta deltas}.
+ * Instances are produced by the {@link nodeBaseDeserializerWithIdMapping} function.
+ */
+export declare class IdMapping {
+    nodesById: NodesById;
+    constructor(nodesById: NodesById);
+    fromId(id: Id): INodeBase;
+    fromRefId(idOrUnresolved: IdOrUnresolved): SingleRef<INodeBase>;
+    updateWith(node: INodeBase): void;
+}
+export {};
+//# sourceMappingURL=id-mapping.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"id-mapping.d.ts","sourceRoot":"","sources":["../src/id-mapping.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAC,EAAE,EAAE,cAAc,EAAE,SAAS,EAAa,MAAM,eAAe,CAAC;AAExE,OAAO,EAAC,SAAS,EAAC,MAAM,YAAY,CAAC;AAGrC,KAAK,SAAS,GAAG;IAAE,CAAC,EAAE,EAAE,EAAE,GAAG,SAAS,CAAA;CAAC,CAAC;AAGxC;;;;GAIG;AACH,qBAAa,SAAS;IAElB,SAAS,EAAE,SAAS,CAAC;gBACT,SAAS,EAAE,SAAS;IAIhC,MAAM,CAAC,EAAE,EAAE,EAAE,GAAG,SAAS;IAOzB,SAAS,CAAC,cAAc,EAAE,cAAc,GAAG,SAAS,CAAC,SAAS,CAAC;IAM/D,UAAU,CAAC,IAAI,EAAE,SAAS;CAM7B"}

package/dist/id-mapping.js

@@ -0,0 +1,44 @@
+// Copyright 2025 TRUMPF Laser SE and other contributors
+//
+// 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.
+//
+// SPDX-FileCopyrightText: 2025 TRUMPF Laser SE and other contributors
+// SPDX-License-Identifier: Apache-2.0
+import { unresolved } from "@lionweb/core";
+/**
+ * Maintains a mapping ID → node,
+ * which is primarily used for efficiently applying {@link IDelta deltas}.
+ * Instances are produced by the {@link nodeBaseDeserializerWithIdMapping} function.
+ */
+export class IdMapping {
+    constructor(nodesById) {
+        this.nodesById = { ...nodesById };
+    }
+    fromId(id) {
+        if (!(id in this.nodesById)) {
+            throw new Error(`node with id=${id} not in ID mapping`);
+        }
+        return this.nodesById[id];
+    }
+    fromRefId(idOrUnresolved) {
+        return idOrUnresolved === null
+            ? null
+            : (this.nodesById[idOrUnresolved] ?? unresolved);
+    }
+    updateWith(node) {
+        this.nodesById[node.id] = node;
+        node.children // recurse into all children
+            .forEach((child) => this.updateWith(child));
+    }
+}
+//# sourceMappingURL=id-mapping.js.map

package/dist/id-mapping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id-mapping.js","sourceRoot":"","sources":["../src/id-mapping.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,EAAE;AACF,iEAAiE;AACjE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,EAAE;AACF,sEAAsE;AACtE,sCAAsC;AAEtC,OAAO,EAAgC,UAAU,EAAC,MAAM,eAAe,CAAC;AAQxE;;;;GAIG;AACH,MAAM,OAAO,SAAS;IAGlB,YAAY,SAAoB;QAC5B,IAAI,CAAC,SAAS,GAAG,EAAC,GAAG,SAAS,EAAC,CAAC;IACpC,CAAC;IAED,MAAM,CAAC,EAAM;QACT,IAAI,CAAC,CAAC,EAAE,IAAI,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,gBAAgB,EAAE,oBAAoB,CAAC,CAAC;QAC5D,CAAC;QACD,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IAC9B,CAAC;IAED,SAAS,CAAC,cAA8B;QACpC,OAAO,cAAc,KAAK,IAAI;YAC1B,CAAC,CAAC,IAAI;YACN,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,UAAU,CAAC,CAAC;IACzD,CAAC;IAED,UAAU,CAAC,IAAe;QACtB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC;QAC/B,IAAI,CAAC,QAAQ,CAAG,4BAA4B;aACvC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;IACpD,CAAC;CAEJ"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export * from "./base-types.js";
+export * from "./convenience.js";
+export * from "./deltas/index.js";
+export * from "./deserializer.js";
+export { deepDuplicateWith } from "./duplicator.js";
+export * from "./id-mapping.js";
+export * from "./lionCore_builtins.g.js";
+export { serializeNodeBases } from "./serializer.js";
+export * from "./value-managers/index.js";
+export { asTreeTextWith } from "./textualizer.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":"AAiBA,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAC,iBAAiB,EAAC,MAAM,iBAAiB,CAAC;AAClD,cAAc,iBAAiB,CAAC;AAEhC,cAAc,0BAA0B,CAAC;AACzC,OAAO,EAAC,kBAAkB,EAAC,MAAM,iBAAiB,CAAC;AACnD,cAAc,2BAA2B,CAAC;AAC1C,OAAO,EAAC,cAAc,EAAC,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,28 @@
+// Copyright 2025 TRUMPF Laser SE and other contributors
+//
+// 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.
+//
+// SPDX-FileCopyrightText: 2025 TRUMPF Laser SE and other contributors
+// SPDX-License-Identifier: Apache-2.0
+export * from "./base-types.js";
+export * from "./convenience.js";
+export * from "./deltas/index.js";
+export * from "./deserializer.js";
+export { deepDuplicateWith } from "./duplicator.js";
+export * from "./id-mapping.js";
+// skip linking.js: see comment there
+export * from "./lionCore_builtins.g.js";
+export { serializeNodeBases } from "./serializer.js";
+export * from "./value-managers/index.js";
+export { asTreeTextWith } from "./textualizer.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,wDAAwD;AACxD,EAAE;AACF,iEAAiE;AACjE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,EAAE;AACF,sEAAsE;AACtE,sCAAsC;AAEtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAC,iBAAiB,EAAC,MAAM,iBAAiB,CAAC;AAClD,cAAc,iBAAiB,CAAC;AAChC,qCAAqC;AACrC,cAAc,0BAA0B,CAAC;AACzC,OAAO,EAAC,kBAAkB,EAAC,MAAM,iBAAiB,CAAC;AACnD,cAAc,2BAA2B,CAAC;AAC1C,OAAO,EAAC,cAAc,EAAC,MAAM,kBAAkB,CAAC"}