@lionweb/class-core 0.8.0-beta.0 → 0.8.0-beta.1

package/CHANGELOG.md

@@ -11,6 +11,8 @@
       *Note* that this is a **breaking change**, but these parameters weren’t used outside of tests anyway.
 * Simplify `Deserializer` type, by removing the `dependentNodes` parameter: (only) pass an appropriate instance of `IdMapping` instead.
   *Note* that this is a **breaking change**, but either parameter is optional and carries the same information, so this should avoid confusion and misuse.
+* Add a `Forest` class that encapsulates a “forest” of partitions, together with their ID mapping, a factory, a deserializer – also deserializing into the forest –, and methods to apply deltas.
+    * Add a `ObservableForest` class that is Mobx-observable.
 
 
 ## 0.7.2

package/dist/base-types.d.ts

@@ -155,7 +155,7 @@ export declare abstract class NodeBase implements INodeBase {
 }
 /**
  * A type for functions that acts as factories, creating an instance of {@link INodeBase}
- * matching the given {@link Classifier classifier} and the given ID (of type {@link Id}).
+ * matching the given {@link Classifier classifier} and the given ID (of type {@link LionWebId}).
  */
 export type NodeBaseFactory = (classifier: Classifier, id: LionWebId) => INodeBase;
 /**
@@ -169,4 +169,13 @@ export interface ILanguageBase {
     factory(receiveDelta?: DeltaReceiver): NodeBaseFactory;
     enumLiteralFrom<T>(enumerationLiteral: EnumerationLiteral): T;
 }
+/**
+ * The configuration required to be able to instantiate a {@link NodeBaseFactory factory} for a set of languages.
+ */
+export type FactoryConfiguration = {
+    /** The {@link ILanguageBase}s for (at least) all the languages used, minus LionCore M3 and built-ins. */
+    languageBases: ILanguageBase[];
+    /** An optional {@link DeltaReceiver} that will be injected in all {@link INodeBase nodes} created. */
+    receiveDelta?: DeltaReceiver;
+};
 //# sourceMappingURL=base-types.d.ts.map

package/dist/base-types.d.ts.map

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

package/dist/deserializer.d.ts

@@ -1,6 +1,6 @@
 import { PropertyValueDeserializer, SimplisticHandler } from "@lionweb/core";
 import { LionWebJsonChunk } from "@lionweb/json";
-import { DeltaReceiver, IdMapping, ILanguageBase, INodeBase } from "./index.js";
+import { DeltaReceiver, IdMapping, ILanguageBase, INodeBase, FactoryConfiguration } from "./index.js";
 /**
  * A type for deserializer functions that are parametrized in their return type.
  */
@@ -22,10 +22,6 @@ export type RootsWithIdMapping = {
  * (and partially optional).
  */
 export type DeserializerConfiguration = {
-    /** The {@link ILanguageBase}s for (at least) all the languages used in the {@link LionWebJsonChunk} to deserialize, minus LionCore M3 and built-ins. */
-    languageBases: ILanguageBase[];
-    /** An optional {@link DeltaReceiver} that will be injected in all {@link INodeBase nodes} created. */
-    receiveDelta?: DeltaReceiver;
     /** Default: {@link builtinPropertyValueDeserializer}. */
     propertyValueDeserializer?: PropertyValueDeserializer;
     /** Default: {@link defaultSimplisticHandler}. */
@@ -41,7 +37,7 @@ declare function nodeBaseDeserializerWithIdMapping(languageBases: ILanguageBase[
 /**
  * @param configuration a {@link DeserializerConfiguration configuration object} for the deserializer.
  */
-declare function nodeBaseDeserializerWithIdMapping(configuration: DeserializerConfiguration): Deserializer<RootsWithIdMapping>;
+declare function nodeBaseDeserializerWithIdMapping(configuration: FactoryConfiguration & DeserializerConfiguration): 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.
  * Deprecated:
@@ -52,6 +48,6 @@ declare function nodeBaseDeserializer(languageBases: ILanguageBase[], receiveDel
 /**
  * @param configuration a {@link DeserializerConfiguration configuration object} for the deserializer.
  */
-declare function nodeBaseDeserializer(configuration: DeserializerConfiguration): Deserializer<INodeBase[]>;
+declare function nodeBaseDeserializer(configuration: FactoryConfiguration & DeserializerConfiguration): Deserializer<INodeBase[]>;
 export { nodeBaseDeserializerWithIdMapping, nodeBaseDeserializer };
 //# sourceMappingURL=deserializer.d.ts.map

package/dist/deserializer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deserializer.d.ts","sourceRoot":"","sources":["../src/deserializer.ts"],"names":[],"mappings":"AAiBA,OAAO,EASH,yBAAyB,EAEzB,iBAAiB,EAEpB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAa,gBAAgB,EAAmB,MAAM,eAAe,CAAA;AAG5E,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAK/E;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI;AAC1B,uEAAuE;AACvE,kBAAkB,EAAE,gBAAgB;AACpC,0GAA0G;AAC1G,SAAS,CAAC,EAAE,SAAS,KACpB,CAAC,CAAC;AAGP;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IAAC,SAAS,EAAE,SAAS,CAAA;CAAE,CAAC;AAG9E;;;GAGG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACpC,wJAAwJ;IACxJ,aAAa,EAAE,aAAa,EAAE,CAAC;IAC/B,sGAAsG;IACtG,YAAY,CAAC,EAAE,aAAa,CAAC;IAC7B,yDAAyD;IACzD,yBAAyB,CAAC,EAAE,yBAAyB,CAAC;IACtD,iDAAiD;IACjD,eAAe,CAAC,EAAE,iBAAiB,CAAA;CACtC,CAAC;AAGF;;;;;GAKG;AACH,iBAAS,iCAAiC,CAAC,aAAa,EAAE,aAAa,EAAE,EAAE,YAAY,CAAC,EAAE,aAAa,GAAG,YAAY,CAAC,kBAAkB,CAAC,CAAC;AAC3I;;GAEG;AACH,iBAAS,iCAAiC,CAAC,aAAa,EAAE,yBAAyB,GAAG,YAAY,CAAC,kBAAkB,CAAC,CAAC;AA4IvH;;;;;GAKG;AACH,iBAAS,oBAAoB,CAAC,aAAa,EAAE,aAAa,EAAE,EAAE,YAAY,CAAC,EAAE,aAAa,GAAG,YAAY,CAAC,SAAS,EAAE,CAAC,CAAC;AACvH;;GAEG;AACH,iBAAS,oBAAoB,CAAC,aAAa,EAAE,yBAAyB,GAAG,YAAY,CAAC,SAAS,EAAE,CAAC,CAAC;AAYnG,OAAO,EAAE,iCAAiC,EAAE,oBAAoB,EAAE,CAAC"}
+{"version":3,"file":"deserializer.d.ts","sourceRoot":"","sources":["../src/deserializer.ts"],"names":[],"mappings":"AAiBA,OAAO,EASH,yBAAyB,EAEzB,iBAAiB,EAEpB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAa,gBAAgB,EAAmB,MAAM,eAAe,CAAA;AAG5E,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAKrG;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI;AAC1B,uEAAuE;AACvE,kBAAkB,EAAE,gBAAgB;AACpC,0GAA0G;AAC1G,SAAS,CAAC,EAAE,SAAS,KACpB,CAAC,CAAC;AAGP;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IAAC,SAAS,EAAE,SAAS,CAAA;CAAE,CAAC;AAG9E;;;GAGG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACpC,yDAAyD;IACzD,yBAAyB,CAAC,EAAE,yBAAyB,CAAC;IACtD,iDAAiD;IACjD,eAAe,CAAC,EAAE,iBAAiB,CAAA;CACtC,CAAC;AAGF;;;;;GAKG;AACH,iBAAS,iCAAiC,CAAC,aAAa,EAAE,aAAa,EAAE,EAAE,YAAY,CAAC,EAAE,aAAa,GAAG,YAAY,CAAC,kBAAkB,CAAC,CAAC;AAC3I;;GAEG;AACH,iBAAS,iCAAiC,CAAC,aAAa,EAAE,oBAAoB,GAAG,yBAAyB,GAAG,YAAY,CAAC,kBAAkB,CAAC,CAAC;AA4I9I;;;;;GAKG;AACH,iBAAS,oBAAoB,CAAC,aAAa,EAAE,aAAa,EAAE,EAAE,YAAY,CAAC,EAAE,aAAa,GAAG,YAAY,CAAC,SAAS,EAAE,CAAC,CAAC;AACvH;;GAEG;AACH,iBAAS,oBAAoB,CAAC,aAAa,EAAE,oBAAoB,GAAG,yBAAyB,GAAG,YAAY,CAAC,SAAS,EAAE,CAAC,CAAC;AAY1H,OAAO,EAAE,iCAAiC,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/deserializer.js.map

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

package/dist/forest.d.ts

@@ -0,0 +1,67 @@
+import { LionWebJsonChunk } from "@lionweb/json";
+import { FactoryConfiguration, INodeBase, NodeBaseFactory } from "./base-types.js";
+import { IDelta } from "./deltas/index.js";
+import { Deserializer, DeserializerConfiguration, RootsWithIdMapping } from "./deserializer.js";
+import { IdMapping } from "./id-mapping.js";
+/**
+ * An instance of this class encompasses a complete model (=“forest”), to conveniently encapsulate that.
+ * (Essentially, it’s a sort of in-memory repository.)
+ */
+export declare class Forest {
+    private readonly languageBases;
+    private readonly receiveDelta?;
+    /**
+     * The partitions contained in `this` forest.
+     */
+    readonly partitions: INodeBase[];
+    /**
+     * The {@link IdMapping ID mapping} mapping to all nodes in any of the partitions in `this` forest from the IDs of those nodes **plus** *unattached* nodes.
+     * A node is attached if it’s a partition – i.e., its classifier is marked as a partition –, or if it’s – directly, or indirectly – contained by a partition.
+     * This may happen as a result of deleting nodes, or of unattached nodes being deserialized into `this` forest through the `deserializeInto` or `applyDelta[s]` methods.
+     */
+    readonly idMapping: IdMapping;
+    /**
+     * A {@link NodeBaseFactory factory} for nodes with classifiers from the {@link ILanguageBase language bases} passed during instantiation of `this` forest.
+     * This factory method installs the {@link DeltaReceiver} that may be passed during instantiation of `this` forest.
+     */
+    readonly createNode: NodeBaseFactory;
+    /**
+     * A {@link Deserializer deserializer} that returns roots/partitions together with an ID mapping for all nodes in those.
+     * *Note*: this is primarily for internal use — specifically: to create an event-to-delta translator with.
+     * (That translator uses type from `delta-protocol-common` so we don’t want to have it here.)
+     * Using this method does *not* change `this` forest’s state.
+     */
+    readonly deserializeWithIdMapping: Deserializer<RootsWithIdMapping>;
+    constructor(configuration: FactoryConfiguration & DeserializerConfiguration);
+    private emitDelta;
+    /**
+     * Adds the given `partition` to the partitions of `this` forest – provided it’s not already part of it –,
+     * and emits the corresponding {@link PartitionAddedDelta}.
+     */
+    addPartition: (partition: INodeBase) => void;
+    /**
+     * Deletes the indicated `partition` from the partitions of `this` forest – provided it’s part of it –,
+     * and emits the corresponding {@link PartitionDeletedDelta}.
+     */
+    deletePartition: (partition: INodeBase) => void;
+    /**
+     * Deserializes the given `serializationChunk` and adds any partitions in it to the partitions of `this` forest,
+     * It also updates the ID mapping, including with mappings for deserialized unattached nodes.
+     */
+    deserializeInto: (serializationChunk: LionWebJsonChunk) => INodeBase[];
+    /**
+     * Applies the given `delta`, taking care of updating the state of the internal ID mapping.
+     */
+    applyDelta: (delta: IDelta) => void;
+    /**
+     * Applies the given `deltas`, taking care of updating the state of the internal ID mapping.
+     */
+    applyDeltas: (deltas: IDelta[]) => void;
+}
+/**
+ * “Mobx-ified” version of the {@link Forest} class.
+ */
+export declare class ObservableForest extends Forest {
+    constructor(configuration: FactoryConfiguration & DeserializerConfiguration);
+}
+//# sourceMappingURL=forest.d.ts.map

package/dist/forest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forest.d.ts","sourceRoot":"","sources":["../src/forest.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAGhD,OAAO,EAAE,oBAAoB,EAAiB,SAAS,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACjG,OAAO,EAGH,MAAM,EAIT,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EACH,YAAY,EACZ,yBAAyB,EAEzB,kBAAkB,EACrB,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAG3C;;;GAGG;AACH,qBAAa,MAAM;IAEf,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAiB;IAE/C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAe;IAE7C;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,SAAS,EAAE,CAAA;IAEhC;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;IAE7B;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAA;IAEpC;;;;;OAKG;IACH,QAAQ,CAAC,wBAAwB,EAAE,YAAY,CAAC,kBAAkB,CAAC,CAAA;gBAGvD,aAAa,EAAE,oBAAoB,GAAG,yBAAyB;IAU3E,OAAO,CAAC,SAAS,CAIhB;IAED;;;OAGG;IACH,YAAY,GAAI,WAAW,SAAS,UASnC;IAED;;;OAGG;IACH,eAAe,GAAI,WAAW,SAAS,UAQtC;IAED;;;OAGG;IACH,eAAe,GAAI,oBAAoB,gBAAgB,KAAG,SAAS,EAAE,CAKpE;IAED;;OAEG;IACH,UAAU,GAAI,OAAO,MAAM,UAG1B;IAED;;OAEG;IACH,WAAW,GAAI,QAAQ,MAAM,EAAE,UAE9B;CAEJ;AAGD;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,MAAM;gBAE5B,aAAa,EAAE,oBAAoB,GAAG,yBAAyB;CAc9E"}

package/dist/forest.js

@@ -0,0 +1,109 @@
+// 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 { isPartition } from "@lionweb/core";
+import { action, makeObservable, observable } from "mobx";
+import { applyDeltaWithLookup, PartitionAddedDelta, PartitionDeletedDelta, updateIdMappingWithDelta } from "./deltas/index.js";
+import { nodeBaseDeserializerWithIdMapping } from "./deserializer.js";
+import { combinedFactoryFor } from "./factory.js";
+import { IdMapping } from "./id-mapping.js";
+/**
+ * An instance of this class encompasses a complete model (=“forest”), to conveniently encapsulate that.
+ * (Essentially, it’s a sort of in-memory repository.)
+ */
+export class Forest {
+    constructor(configuration) {
+        this.emitDelta = (thunk) => {
+            if (this.receiveDelta) {
+                this.receiveDelta(thunk());
+            }
+        };
+        /**
+         * Adds the given `partition` to the partitions of `this` forest – provided it’s not already part of it –,
+         * and emits the corresponding {@link PartitionAddedDelta}.
+         */
+        this.addPartition = (partition) => {
+            if (!isPartition(partition.classifier)) {
+                throw new Error(`node with ID ${partition.id} is a ${partition.classifier.name} which is not a <<partition>> concept`);
+            }
+            if (this.partitions.indexOf(partition) === -1) {
+                this.partitions.push(partition);
+                this.idMapping.updateWith(partition);
+                this.emitDelta(() => new PartitionAddedDelta(partition));
+            } // else: ignore; already done
+        };
+        /**
+         * Deletes the indicated `partition` from the partitions of `this` forest – provided it’s part of it –,
+         * and emits the corresponding {@link PartitionDeletedDelta}.
+         */
+        this.deletePartition = (partition) => {
+            const index = this.partitions.indexOf(partition);
+            if (index > -1) {
+                this.partitions.splice(index, 1);
+                this.emitDelta(() => new PartitionDeletedDelta(partition));
+            }
+            else {
+                throw new Error(`node with id "${partition.id}" is not an added partition`);
+            }
+        };
+        /**
+         * Deserializes the given `serializationChunk` and adds any partitions in it to the partitions of `this` forest,
+         * It also updates the ID mapping, including with mappings for deserialized unattached nodes.
+         */
+        this.deserializeInto = (serializationChunk) => {
+            const { roots: newRoots, idMapping: newIdMapping } = this.deserializeWithIdMapping(serializationChunk, this.idMapping);
+            this.partitions.push(...newRoots.filter((newRoot) => isPartition(newRoot.classifier)));
+            this.idMapping.mergeIn(newIdMapping); // also merge in new unattached, non-partition roots
+            return newRoots;
+        };
+        /**
+         * Applies the given `delta`, taking care of updating the state of the internal ID mapping.
+         */
+        this.applyDelta = (delta) => {
+            applyDeltaWithLookup(this.idMapping, delta, () => this.partitions);
+            updateIdMappingWithDelta(this.idMapping, delta);
+        };
+        /**
+         * Applies the given `deltas`, taking care of updating the state of the internal ID mapping.
+         */
+        this.applyDeltas = (deltas) => {
+            deltas.forEach((delta) => this.applyDelta(delta));
+        };
+        this.languageBases = configuration.languageBases;
+        this.receiveDelta = configuration.receiveDelta;
+        this.partitions = [];
+        this.idMapping = new IdMapping({});
+        this.createNode = combinedFactoryFor(this.languageBases, this.receiveDelta);
+        this.deserializeWithIdMapping = nodeBaseDeserializerWithIdMapping(configuration);
+    }
+}
+/**
+ * “Mobx-ified” version of the {@link Forest} class.
+ */
+export class ObservableForest extends Forest {
+    constructor(configuration) {
+        super(configuration);
+        makeObservable(this, {
+            partitions: observable,
+            addPartition: action,
+            deserializeInto: action,
+            applyDelta: action,
+            applyDeltas: action
+        });
+    }
+}
+// (but also see: https://mobx.js.org/subclassing.html)
+//# sourceMappingURL=forest.js.map

package/dist/forest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forest.js","sourceRoot":"","sources":["../src/forest.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,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAE3C,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,MAAM,CAAA;AAGzD,OAAO,EACH,oBAAoB,EAGpB,mBAAmB,EACnB,qBAAqB,EACrB,wBAAwB,EAC3B,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAGH,iCAAiC,EAEpC,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAG3C;;;GAGG;AACH,MAAM,OAAO,MAAM;IAiCf,YAAY,aAA+D;QAUnE,cAAS,GAAG,CAAC,KAAmB,EAAE,EAAE;YACxC,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;gBACpB,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC,CAAA;YAC9B,CAAC;QACL,CAAC,CAAA;QAED;;;WAGG;QACH,iBAAY,GAAG,CAAC,SAAoB,EAAE,EAAE;YACpC,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC;gBACrC,MAAM,IAAI,KAAK,CAAC,gBAAgB,SAAS,CAAC,EAAE,SAAS,SAAS,CAAC,UAAU,CAAC,IAAI,uCAAuC,CAAC,CAAA;YAC1H,CAAC;YACD,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;gBAC5C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;gBAC/B,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,SAAS,CAAC,CAAA;gBACpC,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,IAAI,mBAAmB,CAAC,SAAS,CAAC,CAAC,CAAA;YAC5D,CAAC,CAAC,6BAA6B;QACnC,CAAC,CAAA;QAED;;;WAGG;QACH,oBAAe,GAAG,CAAC,SAAoB,EAAE,EAAE;YACvC,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;YAChD,IAAI,KAAK,GAAG,CAAC,CAAC,EAAE,CAAC;gBACb,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;gBAChC,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,IAAI,qBAAqB,CAAC,SAAS,CAAC,CAAC,CAAA;YAC9D,CAAC;iBAAM,CAAC;gBACJ,MAAM,IAAI,KAAK,CAAC,iBAAiB,SAAS,CAAC,EAAE,6BAA6B,CAAC,CAAA;YAC/E,CAAC;QACL,CAAC,CAAA;QAED;;;WAGG;QACH,oBAAe,GAAG,CAAC,kBAAoC,EAAe,EAAE;YACpE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC,wBAAwB,CAAC,kBAAkB,EAAE,IAAI,CAAC,SAAS,CAAC,CAAA;YACtH,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAA;YACtF,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,YAAY,CAAC,CAAA,CAAI,oDAAoD;YAC5F,OAAO,QAAQ,CAAA;QACnB,CAAC,CAAA;QAED;;WAEG;QACH,eAAU,GAAG,CAAC,KAAa,EAAE,EAAE;YAC3B,oBAAoB,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;YAClE,wBAAwB,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAA;QACnD,CAAC,CAAA;QAED;;WAEG;QACH,gBAAW,GAAG,CAAC,MAAgB,EAAE,EAAE;YAC/B,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAA;QACrD,CAAC,CAAA;QApEG,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC,aAAa,CAAA;QAChD,IAAI,CAAC,YAAY,GAAG,aAAa,CAAC,YAAY,CAAA;QAC9C,IAAI,CAAC,UAAU,GAAG,EAAE,CAAA;QACpB,IAAI,CAAC,SAAS,GAAG,IAAI,SAAS,CAAC,EAAE,CAAC,CAAA;QAClC,IAAI,CAAC,UAAU,GAAG,kBAAkB,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,YAAY,CAAC,CAAA;QAC3E,IAAI,CAAC,wBAAwB,GAAG,iCAAiC,CAAC,aAAa,CAAC,CAAA;IACpF,CAAC;CAgEJ;AAGD;;GAEG;AACH,MAAM,OAAO,gBAAiB,SAAQ,MAAM;IAExC,YAAY,aAA+D;QACvE,KAAK,CAAC,aAAa,CAAC,CAAA;QACpB,cAAc,CACV,IAAI,EACJ;YACI,UAAU,EAAE,UAAU;YACtB,YAAY,EAAE,MAAM;YACpB,eAAe,EAAE,MAAM;YACvB,UAAU,EAAE,MAAM;YAClB,WAAW,EAAE,MAAM;SACtB,CACJ,CAAA;IACL,CAAC;CAEJ;AACD,uDAAuD"}

package/dist/id-mapping.d.ts

@@ -42,7 +42,8 @@ export declare class IdMapping {
      */
     reinitializeWith: (nodesById: NodesById) => void;
     /**
-     * Merges the given `that` {@link IdMapping} **in**to `this`.
+     * Merges the given `that` {@link IdMapping} **in**to `this`,
+     * overwriting any previous mappings in `this`.
      */
     mergeIn: (that: IdMapping) => void;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"id-mapping.d.ts","sourceRoot":"","sources":["../src/id-mapping.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,SAAS,EAAc,MAAM,eAAe,CAAA;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAEzC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAGhD;;GAEG;AACH,KAAK,SAAS,GAAG;IAAE,CAAC,EAAE,EAAE,SAAS,GAAG,SAAS,CAAA;CAAE,CAAA;AAG/C;;;;GAIG;AACH,qBAAa,SAAS;IAElB,OAAO,CAAC,SAAS,CAAY;gBACjB,SAAS,EAAE,SAAS;IAKhC;;;OAGG;IACH,MAAM,GAAI,IAAI,SAAS,KAAG,SAAS,CAKlC;IAED;;;OAGG;IACH,SAAS,GAAI,IAAI,SAAS,KAAG,CAAC,SAAS,GAAG,SAAS,CAAC,CAC7B;IAEvB;;;OAGG;IACH,SAAS,GAAI,gBAAgB,cAAc,KAAG,SAAS,CAAC,SAAS,CAAC,CAGT;IAEzD;;OAEG;IACH,UAAU,GAAI,MAAM,SAAS,UAK5B;IAED;;;;OAIG;IACH,gBAAgB,GAAI,WAAW,SAAS,UAEvC;IAED;;OAEG;IACH,OAAO,GAAI,MAAM,SAAS,UAIzB;CAEJ"}
+{"version":3,"file":"id-mapping.d.ts","sourceRoot":"","sources":["../src/id-mapping.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,SAAS,EAAc,MAAM,eAAe,CAAA;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAEzC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAGhD;;GAEG;AACH,KAAK,SAAS,GAAG;IAAE,CAAC,EAAE,EAAE,SAAS,GAAG,SAAS,CAAA;CAAE,CAAA;AAG/C;;;;GAIG;AACH,qBAAa,SAAS;IAElB,OAAO,CAAC,SAAS,CAAY;gBACjB,SAAS,EAAE,SAAS;IAKhC;;;OAGG;IACH,MAAM,GAAI,IAAI,SAAS,KAAG,SAAS,CAKlC;IAED;;;OAGG;IACH,SAAS,GAAI,IAAI,SAAS,KAAG,CAAC,SAAS,GAAG,SAAS,CAAC,CAC7B;IAEvB;;;OAGG;IACH,SAAS,GAAI,gBAAgB,cAAc,KAAG,SAAS,CAAC,SAAS,CAAC,CAGT;IAEzD;;OAEG;IACH,UAAU,GAAI,MAAM,SAAS,UAK5B;IAED;;;;OAIG;IACH,gBAAgB,GAAI,WAAW,SAAS,UAEvC;IAED;;;OAGG;IACH,OAAO,GAAI,MAAM,SAAS,UAIzB;CAEJ"}

package/dist/id-mapping.js

@@ -63,7 +63,8 @@ export class IdMapping {
             this.nodesById = nodesById;
         };
         /**
-         * Merges the given `that` {@link IdMapping} **in**to `this`.
+         * Merges the given `that` {@link IdMapping} **in**to `this`,
+         * overwriting any previous mappings in `this`.
          */
         this.mergeIn = (that) => {
             for (const id in that.nodesById) {

package/dist/id-mapping.js.map

@@ -1 +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,EAAa,UAAU,EAAE,MAAM,eAAe,CAAA;AAarD;;;;GAIG;AACH,MAAM,OAAO,SAAS;IAGlB,YAAY,SAAoB;QAGhC,iEAAiE;QAEjE;;;WAGG;QACH,WAAM,GAAG,CAAC,EAAa,EAAa,EAAE;YAClC,IAAI,CAAC,CAAC,EAAE,IAAI,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC1B,MAAM,IAAI,KAAK,CAAC,gBAAgB,EAAE,oBAAoB,CAAC,CAAC;YAC5D,CAAC;YACD,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QAC9B,CAAC,CAAA;QAED;;;WAGG;QACH,cAAS,GAAG,CAAC,EAAa,EAA2B,EAAE,CACnD,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QAEvB;;;WAGG;QACH,cAAS,GAAG,CAAC,cAA8B,EAAwB,EAAE,CACjE,cAAc,KAAK,UAAU;YACzB,CAAC,CAAC,UAAU;YACZ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,UAAU,CAAC,CAAC;QAEzD;;WAEG;QACH,eAAU,GAAG,CAAC,IAAe,EAAE,EAAE;YAC7B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC;YAC/B,IAAI,CAAC,QAAQ,CAAG,4BAA4B;iBACvC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;YAChD,iGAAiG;QACrG,CAAC,CAAA;QAED;;;;WAIG;QACH,qBAAgB,GAAG,CAAC,SAAoB,EAAE,EAAE;YACxC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC/B,CAAC,CAAA;QAED;;WAEG;QACH,YAAO,GAAG,CAAC,IAAe,EAAE,EAAE;YAC1B,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;gBAC9B,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;YAC5C,CAAC;QACL,CAAC,CAAA;QAzDG,IAAI,CAAC,SAAS,GAAG,EAAC,GAAG,SAAS,EAAC,CAAC;IACpC,CAAC;CA0DJ"}
+{"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,EAAa,UAAU,EAAE,MAAM,eAAe,CAAA;AAarD;;;;GAIG;AACH,MAAM,OAAO,SAAS;IAGlB,YAAY,SAAoB;QAGhC,iEAAiE;QAEjE;;;WAGG;QACH,WAAM,GAAG,CAAC,EAAa,EAAa,EAAE;YAClC,IAAI,CAAC,CAAC,EAAE,IAAI,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC1B,MAAM,IAAI,KAAK,CAAC,gBAAgB,EAAE,oBAAoB,CAAC,CAAC;YAC5D,CAAC;YACD,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QAC9B,CAAC,CAAA;QAED;;;WAGG;QACH,cAAS,GAAG,CAAC,EAAa,EAA2B,EAAE,CACnD,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QAEvB;;;WAGG;QACH,cAAS,GAAG,CAAC,cAA8B,EAAwB,EAAE,CACjE,cAAc,KAAK,UAAU;YACzB,CAAC,CAAC,UAAU;YACZ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,UAAU,CAAC,CAAC;QAEzD;;WAEG;QACH,eAAU,GAAG,CAAC,IAAe,EAAE,EAAE;YAC7B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC;YAC/B,IAAI,CAAC,QAAQ,CAAG,4BAA4B;iBACvC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;YAChD,iGAAiG;QACrG,CAAC,CAAA;QAED;;;;WAIG;QACH,qBAAgB,GAAG,CAAC,SAAoB,EAAE,EAAE;YACxC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC/B,CAAC,CAAA;QAED;;;WAGG;QACH,YAAO,GAAG,CAAC,IAAe,EAAE,EAAE;YAC1B,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;gBAC9B,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;YAC5C,CAAC;QACL,CAAC,CAAA;QA1DG,IAAI,CAAC,SAAS,GAAG,EAAC,GAAG,SAAS,EAAC,CAAC;IACpC,CAAC;CA2DJ"}

package/dist/index.d.ts

@@ -5,6 +5,7 @@ export * from "./deserializer.js";
 export { deepDuplicateWith } from "./duplicator.js";
 export * from "./id-mapping.js";
 export { combinedFactoryFor } from "./factory.js";
+export { Forest, ObservableForest } from "./forest.js";
 export * from "./LionCore_builtins.g.js";
 export type { IdOrUnresolved } from "./references.js";
 export { idFrom } from "./references.js";

package/dist/index.d.ts.map

@@ -1 +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,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAElD,cAAc,0BAA0B,CAAC;AACzC,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,2BAA2B,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAClF,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,cAAc,2BAA2B,CAAC"}
+{"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,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEvD,cAAc,0BAA0B,CAAC;AACzC,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,2BAA2B,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAClF,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,cAAc,2BAA2B,CAAC"}

package/dist/index.js

@@ -21,6 +21,7 @@ export * from "./deserializer.js";
 export { deepDuplicateWith } from "./duplicator.js";
 export * from "./id-mapping.js";
 export { combinedFactoryFor } from "./factory.js";
+export { Forest, ObservableForest } from "./forest.js";
 // skip linking.js: see comment there
 export * from "./LionCore_builtins.g.js";
 export { idFrom } from "./references.js";

package/dist/index.js.map

@@ -1 +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,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,qCAAqC;AACrC,cAAc,0BAA0B,CAAC;AAEzC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,2BAA2B,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAClF,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,cAAc,2BAA2B,CAAC"}
+{"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,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACvD,qCAAqC;AACrC,cAAc,0BAA0B,CAAC;AAEzC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,2BAA2B,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAClF,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,cAAc,2BAA2B,CAAC"}

package/dist/linking.d.ts

@@ -11,11 +11,11 @@ import { INodeBase } from "./index.js";
  * 2. `feature` — the {@link Link link} feature to install on, or `null` to indicate that it's an annotation.
  * 3. `nodesIds` — are the IDs of the nodes to install.
  * 4. *optional* `originalReferenceTargets` — are the original reference targets of a {@link Reference reference} feature.
- *  This element is only present when the feature is a {@link Reference reference} feature.
+ *  This element is only present when the feature is a {@link Reference reference}.
  *  The `nodesIds` and `originalReferenceTargets` match up per index.
  *
  * Note: **DON'T** export this types from the package,
- * as these are only used to align the deserializer and deep-cloner.
+ * as these are only used to align the deserializer and deep-duplicator.
  */
 export type NodesToInstall = [container: INodeBase, feature: Link | null, nodesIds: LionWebId[], originalReferenceTargets?: INodeBase[]];
 //# sourceMappingURL=linking.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@lionweb/class-core",
-    "version": "0.8.0-beta.0",
+    "version": "0.8.0-beta.1",
     "description": "Generic, language-aspecific base types for generated TypeScript APIs",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",
@@ -27,9 +27,9 @@
         "release": "npm publish"
     },
     "dependencies": {
-        "@lionweb/core": "0.8.0-beta.0",
-        "@lionweb/json": "0.8.0-beta.0",
-        "@lionweb/ts-utils": "0.8.0-beta.0",
+        "@lionweb/core": "0.8.0-beta.1",
+        "@lionweb/json": "0.8.0-beta.1",
+        "@lionweb/ts-utils": "0.8.0-beta.1",
         "littoral-templates": "0.5.1",
         "mobx": "6.13.7"
     }

package/src/base-types.ts

@@ -335,7 +335,7 @@ export abstract class NodeBase implements INodeBase {
 
 /**
  * A type for functions that acts as factories, creating an instance of {@link INodeBase}
- * matching the given {@link Classifier classifier} and the given ID (of type {@link Id}).
+ * matching the given {@link Classifier classifier} and the given ID (of type {@link LionWebId}).
  */
 export type NodeBaseFactory = (classifier: Classifier, id: LionWebId) => INodeBase;
 
@@ -351,3 +351,14 @@ export interface ILanguageBase {
     enumLiteralFrom<T>(enumerationLiteral: EnumerationLiteral): T;
 }
 
+
+/**
+ * The configuration required to be able to instantiate a {@link NodeBaseFactory factory} for a set of languages.
+ */
+export type FactoryConfiguration = {
+    /** The {@link ILanguageBase}s for (at least) all the languages used, minus LionCore M3 and built-ins. */
+    languageBases: ILanguageBase[],
+    /** An optional {@link DeltaReceiver} that will be injected in all {@link INodeBase nodes} created. */
+    receiveDelta?: DeltaReceiver
+};
+

package/src/deserializer.ts

@@ -32,7 +32,7 @@ import {
 import { LionWebId, LionWebJsonChunk, LionWebJsonNode } from "@lionweb/json"
 import { byIdMap, keepDefineds } from "@lionweb/ts-utils"
 
-import { DeltaReceiver, IdMapping, ILanguageBase, INodeBase } from "./index.js"
+import { DeltaReceiver, IdMapping, ILanguageBase, INodeBase, FactoryConfiguration } from "./index.js"
 import { combinedLanguageBaseLookupFor } from "./factory.js"
 import { NodesToInstall } from "./linking.js"
 
@@ -60,10 +60,6 @@ export type RootsWithIdMapping = { roots: INodeBase[], idMapping: IdMapping };
  * (and partially optional).
  */
 export type DeserializerConfiguration = {
-    /** The {@link ILanguageBase}s for (at least) all the languages used in the {@link LionWebJsonChunk} to deserialize, minus LionCore M3 and built-ins. */
-    languageBases: ILanguageBase[],
-    /** An optional {@link DeltaReceiver} that will be injected in all {@link INodeBase nodes} created. */
-    receiveDelta?: DeltaReceiver,
     /** Default: {@link builtinPropertyValueDeserializer}. */
     propertyValueDeserializer?: PropertyValueDeserializer,
     /** Default: {@link defaultSimplisticHandler}. */
@@ -81,8 +77,8 @@ function nodeBaseDeserializerWithIdMapping(languageBases: ILanguageBase[], recei
 /**
  * @param configuration a {@link DeserializerConfiguration configuration object} for the deserializer.
  */
-function nodeBaseDeserializerWithIdMapping(configuration: DeserializerConfiguration): Deserializer<RootsWithIdMapping>;
-function nodeBaseDeserializerWithIdMapping(languageBasesOrConfiguration: ILanguageBase[] | DeserializerConfiguration, mayBeReceiveDelta?: DeltaReceiver): Deserializer<RootsWithIdMapping> {
+function nodeBaseDeserializerWithIdMapping(configuration: FactoryConfiguration & DeserializerConfiguration): Deserializer<RootsWithIdMapping>;
+function nodeBaseDeserializerWithIdMapping(languageBasesOrConfiguration: ILanguageBase[] | (FactoryConfiguration & DeserializerConfiguration), mayBeReceiveDelta?: DeltaReceiver): Deserializer<RootsWithIdMapping> {
     const [languageBases, receiveDelta, propertyValueDeserializer, problemsHandler] = Array.isArray(languageBasesOrConfiguration)
         ? [languageBasesOrConfiguration, mayBeReceiveDelta, builtinPropertyValueDeserializer, defaultSimplisticHandler]
         : [languageBasesOrConfiguration.languageBases, languageBasesOrConfiguration.receiveDelta, languageBasesOrConfiguration.propertyValueDeserializer ?? builtinPropertyValueDeserializer, languageBasesOrConfiguration.problemsHandler ?? defaultSimplisticHandler];
@@ -231,8 +227,8 @@ function nodeBaseDeserializer(languageBases: ILanguageBase[], receiveDelta?: Del
 /**
  * @param configuration a {@link DeserializerConfiguration configuration object} for the deserializer.
  */
-function nodeBaseDeserializer(configuration: DeserializerConfiguration): Deserializer<INodeBase[]>;
-function nodeBaseDeserializer(languageBasesOrConfiguration: ILanguageBase[] | DeserializerConfiguration, receiveDelta?: DeltaReceiver): Deserializer<INodeBase[]> {
+function nodeBaseDeserializer(configuration: FactoryConfiguration & DeserializerConfiguration): Deserializer<INodeBase[]>;
+function nodeBaseDeserializer(languageBasesOrConfiguration: ILanguageBase[] | (FactoryConfiguration & DeserializerConfiguration), receiveDelta?: DeltaReceiver): Deserializer<INodeBase[]> {
     return (
         serializationChunk,
         idMapping

package/src/forest.ts

@@ -0,0 +1,173 @@
+// 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 { isPartition } from "@lionweb/core"
+import { LionWebJsonChunk } from "@lionweb/json"
+import { action, makeObservable, observable } from "mobx"
+
+import { FactoryConfiguration, ILanguageBase, INodeBase, NodeBaseFactory } from "./base-types.js"
+import {
+    applyDeltaWithLookup,
+    DeltaReceiver,
+    IDelta,
+    PartitionAddedDelta,
+    PartitionDeletedDelta,
+    updateIdMappingWithDelta
+} from "./deltas/index.js"
+import {
+    Deserializer,
+    DeserializerConfiguration,
+    nodeBaseDeserializerWithIdMapping,
+    RootsWithIdMapping
+} from "./deserializer.js"
+import { combinedFactoryFor } from "./factory.js"
+import { IdMapping } from "./id-mapping.js"
+
+
+/**
+ * An instance of this class encompasses a complete model (=“forest”), to conveniently encapsulate that.
+ * (Essentially, it’s a sort of in-memory repository.)
+ */
+export class Forest {
+
+    private readonly languageBases: ILanguageBase[]
+
+    private readonly receiveDelta?: DeltaReceiver
+
+    /**
+     * The partitions contained in `this` forest.
+     */
+    readonly partitions: INodeBase[]
+
+    /**
+     * The {@link IdMapping ID mapping} mapping to all nodes in any of the partitions in `this` forest from the IDs of those nodes **plus** *unattached* nodes.
+     * A node is attached if it’s a partition – i.e., its classifier is marked as a partition –, or if it’s – directly, or indirectly – contained by a partition.
+     * This may happen as a result of deleting nodes, or of unattached nodes being deserialized into `this` forest through the `deserializeInto` or `applyDelta[s]` methods.
+     */
+    readonly idMapping: IdMapping   // We need to expose this to be able to instantiate an EventToDeltaTranslator!
+
+    /**
+     * A {@link NodeBaseFactory factory} for nodes with classifiers from the {@link ILanguageBase language bases} passed during instantiation of `this` forest.
+     * This factory method installs the {@link DeltaReceiver} that may be passed during instantiation of `this` forest.
+     */
+    readonly createNode: NodeBaseFactory
+
+    /**
+     * A {@link Deserializer deserializer} that returns roots/partitions together with an ID mapping for all nodes in those.
+     * *Note*: this is primarily for internal use — specifically: to create an event-to-delta translator with.
+     * (That translator uses type from `delta-protocol-common` so we don’t want to have it here.)
+     * Using this method does *not* change `this` forest’s state.
+     */
+    readonly deserializeWithIdMapping: Deserializer<RootsWithIdMapping>
+
+
+    constructor(configuration: FactoryConfiguration & DeserializerConfiguration) {
+        this.languageBases = configuration.languageBases
+        this.receiveDelta = configuration.receiveDelta
+        this.partitions = []
+        this.idMapping = new IdMapping({})
+        this.createNode = combinedFactoryFor(this.languageBases, this.receiveDelta)
+        this.deserializeWithIdMapping = nodeBaseDeserializerWithIdMapping(configuration)
+    }
+
+
+    private emitDelta = (thunk: () => IDelta) => {
+        if (this.receiveDelta) {
+            this.receiveDelta(thunk())
+        }
+    }
+
+    /**
+     * Adds the given `partition` to the partitions of `this` forest – provided it’s not already part of it –,
+     * and emits the corresponding {@link PartitionAddedDelta}.
+     */
+    addPartition = (partition: INodeBase) => {
+        if (!isPartition(partition.classifier)) {
+            throw new Error(`node with ID ${partition.id} is a ${partition.classifier.name} which is not a <<partition>> concept`)
+        }
+        if (this.partitions.indexOf(partition) === -1) {
+            this.partitions.push(partition)
+            this.idMapping.updateWith(partition)
+            this.emitDelta(() => new PartitionAddedDelta(partition))
+        } // else: ignore; already done
+    }
+
+    /**
+     * Deletes the indicated `partition` from the partitions of `this` forest – provided it’s part of it –,
+     * and emits the corresponding {@link PartitionDeletedDelta}.
+     */
+    deletePartition = (partition: INodeBase) => {
+        const index = this.partitions.indexOf(partition)
+        if (index > -1) {
+            this.partitions.splice(index, 1)
+            this.emitDelta(() => new PartitionDeletedDelta(partition))
+        } else {
+            throw new Error(`node with id "${partition.id}" is not an added partition`)
+        }
+    }
+
+    /**
+     * Deserializes the given `serializationChunk` and adds any partitions in it to the partitions of `this` forest,
+     * It also updates the ID mapping, including with mappings for deserialized unattached nodes.
+     */
+    deserializeInto = (serializationChunk: LionWebJsonChunk): INodeBase[] => {
+        const { roots: newRoots, idMapping: newIdMapping } = this.deserializeWithIdMapping(serializationChunk, this.idMapping)
+        this.partitions.push(...newRoots.filter((newRoot) => isPartition(newRoot.classifier)))
+        this.idMapping.mergeIn(newIdMapping)    // also merge in new unattached, non-partition roots
+        return newRoots
+    }
+
+    /**
+     * Applies the given `delta`, taking care of updating the state of the internal ID mapping.
+     */
+    applyDelta = (delta: IDelta) => {
+        applyDeltaWithLookup(this.idMapping, delta, () => this.partitions)
+        updateIdMappingWithDelta(this.idMapping, delta)
+    }
+
+    /**
+     * Applies the given `deltas`, taking care of updating the state of the internal ID mapping.
+     */
+    applyDeltas = (deltas: IDelta[]) => {
+        deltas.forEach((delta) => this.applyDelta(delta))
+    }
+
+}
+
+
+/**
+ * “Mobx-ified” version of the {@link Forest} class.
+ */
+export class ObservableForest extends Forest {
+
+    constructor(configuration: FactoryConfiguration & DeserializerConfiguration) {
+        super(configuration)
+        makeObservable(
+            this,
+            {
+                partitions: observable,
+                addPartition: action,
+                deserializeInto: action,
+                applyDelta: action,
+                applyDeltas: action
+            }
+        )
+    }
+
+}
+// (but also see: https://mobx.js.org/subclassing.html)
+

package/src/id-mapping.ts

@@ -88,7 +88,8 @@ export class IdMapping {
     }
 
     /**
-     * Merges the given `that` {@link IdMapping} **in**to `this`.
+     * Merges the given `that` {@link IdMapping} **in**to `this`,
+     * overwriting any previous mappings in `this`.
      */
     mergeIn = (that: IdMapping) => {
         for (const id in that.nodesById) {

package/src/index.ts

@@ -22,6 +22,7 @@ export * from "./deserializer.js";
 export { deepDuplicateWith } from "./duplicator.js";
 export * from "./id-mapping.js";
 export { combinedFactoryFor } from "./factory.js";
+export { Forest, ObservableForest } from "./forest.js";
 // skip linking.js: see comment there
 export * from "./LionCore_builtins.g.js";
 export type { IdOrUnresolved } from "./references.js";

package/src/linking.ts

@@ -30,11 +30,11 @@ import { INodeBase } from "./index.js"
  * 2. `feature` — the {@link Link link} feature to install on, or `null` to indicate that it's an annotation.
  * 3. `nodesIds` — are the IDs of the nodes to install.
  * 4. *optional* `originalReferenceTargets` — are the original reference targets of a {@link Reference reference} feature.
- *  This element is only present when the feature is a {@link Reference reference} feature.
+ *  This element is only present when the feature is a {@link Reference reference}.
  *  The `nodesIds` and `originalReferenceTargets` match up per index.
  *
  * Note: **DON'T** export this types from the package,
- * as these are only used to align the deserializer and deep-cloner.
+ * as these are only used to align the deserializer and deep-duplicator.
  */
 export type NodesToInstall = [ container: INodeBase, feature: Link | null, nodesIds: LionWebId[], originalReferenceTargets?: INodeBase[] ];