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

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,EAA6B,UAAU,EAAE,MAAM,eAAe,CAAA;AAYrE;;;;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,GAAE,CAAC,IAAe,EAAE,EAAE;YAC5B,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,7 +5,10 @@ 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";
 export { propertyValueSerializerWith, serializeNodeBases } from "./serializer.js";
 export { asTreeTextWith } from "./textualizer.js";
 export * from "./value-managers/index.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,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,8 +21,10 @@ 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";
 export { propertyValueSerializerWith, serializeNodeBases } from "./serializer.js";
 export { asTreeTextWith } from "./textualizer.js";
 export * from "./value-managers/index.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;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/dist/references.d.ts

@@ -0,0 +1,12 @@
+import { SingleRef, unresolved } from "@lionweb/core";
+import { LionWebId } from "@lionweb/json";
+import { INodeBase } from "./base-types.js";
+/**
+ * A type that expresses a value is either an {@link LionWebId} or a value to indicate that resolution to a node previously failed.
+ */
+export type IdOrUnresolved = LionWebId | typeof unresolved;
+/**
+ * @return the ID of a given reference to a {@link INodeBase}, or {@link unresolved} if that reference was previously unresolved.
+ */
+export declare const idFrom: (ref: SingleRef<INodeBase>) => IdOrUnresolved;
+//# sourceMappingURL=references.d.ts.map

package/dist/references.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"references.d.ts","sourceRoot":"","sources":["../src/references.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAEzC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAG3C;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,OAAO,UAAU,CAAC;AAG3D;;GAEG;AACH,eAAO,MAAM,MAAM,GAAI,KAAK,SAAS,CAAC,SAAS,CAAC,KAAG,cACP,CAAA"}

package/dist/{deltas/serialization/serializer-helpers.js → references.js}

@@ -14,16 +14,9 @@
 //
 // SPDX-FileCopyrightText: 2025 TRUMPF Laser SE and other contributors
 // SPDX-License-Identifier: Apache-2.0
-import { builtinPropertyValueSerializer, unresolved } from "@lionweb/core";
-import { propertyValueSerializerWith } from "../../serializer.js";
-/**
- * A function that serializes the given value of the given {@link Property property},
- * using the same {@link builtinPropertyValueSerializer} instance as the {@link serializeNodeBases} function,
- * and the same treatment of enumeration values.
- */
-export const defaultPropertyValueSerializer = propertyValueSerializerWith({ primitiveValueSerializer: builtinPropertyValueSerializer });
+import { unresolved } from "@lionweb/core";
 /**
  * @return the ID of a given reference to a {@link INodeBase}, or {@link unresolved} if that reference was previously unresolved.
  */
-export const idFrom = (ref) => ref === unresolved ? null : ref.id;
-//# sourceMappingURL=serializer-helpers.js.map
+export const idFrom = (ref) => ref === unresolved ? unresolved : ref.id;
+//# sourceMappingURL=references.js.map

package/dist/references.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"references.js","sourceRoot":"","sources":["../src/references.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;AAYrD;;GAEG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,GAAyB,EAAkB,EAAE,CAChE,GAAG,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@lionweb/class-core",
-    "version": "0.7.2",
+    "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.7.2",
-        "@lionweb/json": "0.7.2",
-        "@lionweb/ts-utils": "0.7.2",
+        "@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/deltas/serialization/base.ts

@@ -15,8 +15,10 @@
 // SPDX-FileCopyrightText: 2025 TRUMPF Laser SE and other contributors
 // SPDX-License-Identifier: Apache-2.0
 
+import { builtinPropertyValueSerializer } from "@lionweb/core"
 import { IDelta } from "../base.js"
 import { SerializedDelta } from "./types.g.js"
+import { propertyValueSerializerWith } from "../../serializer.js"
 
 
 /**
@@ -24,3 +26,11 @@ import { SerializedDelta } from "./types.g.js"
  */
 export type DeltaDeserializer = (delta: SerializedDelta) => IDelta;
 
+
+/**
+ * A function that serializes the given value of the given {@link Property property},
+ * using the same {@link builtinPropertyValueSerializer} instance as the {@link serializeNodeBases} function,
+ * and the same treatment of enumeration values.
+ */
+export const defaultPropertyValueSerializer = propertyValueSerializerWith({ primitiveValueSerializer: builtinPropertyValueSerializer })
+

package/src/deltas/serialization/serializer.g.ts

@@ -89,7 +89,8 @@ import {
     ReferenceDeletedSerializedDelta,
     SerializedDelta
 } from "./types.g.js";
-import { idFrom, defaultPropertyValueSerializer } from "./serializer-helpers.js";
+import { defaultPropertyValueSerializer } from "./base.js";
+import { idFrom } from "../../references.js";
 import { serializeNodeBases } from "../../serializer.js";
 
 

package/src/deltas/serialization/types.g.ts

@@ -18,8 +18,8 @@
 // Warning: this file is generated!
 // Modifying it by hand is useless at best, and sabotage at worst.
 
-import { IdOrUnresolved } from "@lionweb/core";
 import { LionWebId, LionWebJsonMetaPointer, LionWebJsonChunk } from "@lionweb/json";
+import { IdOrUnresolved } from "../../references.js";
 
 
 export type SerializedDelta =

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"
 
@@ -41,11 +41,10 @@ import { NodesToInstall } from "./linking.js"
  * A type for deserializer functions that are parametrized in their return type.
  */
 export type Deserializer<T> = (
+    /** The {@link LionWebJsonChunk serialization chunk} to deserialize. */
     serializationChunk: LionWebJsonChunk,
-    dependentNodes?: INodeBase[],
-    idMapping?: IdMapping,
-    propertyValueDeserializer?: PropertyValueDeserializer,
-    problemHandler?: SimplisticHandler
+    /** The {@link IdMapping ID mapping} of existing nodes that the given `serializationChunk` may link to. */
+    idMapping?: IdMapping
 ) => T;
 
 
@@ -56,22 +55,40 @@ export type Deserializer<T> = (
 export type RootsWithIdMapping = { roots: INodeBase[], idMapping: IdMapping };
 
 
+/**
+ * Configuration parameters for a deserializer that are unchanging per invocation of the deserializer
+ * (and partially optional).
+ */
+export type DeserializerConfiguration = {
+    /** Default: {@link builtinPropertyValueDeserializer}. */
+    propertyValueDeserializer?: PropertyValueDeserializer,
+    /** Default: {@link defaultSimplisticHandler}. */
+    problemsHandler?: SimplisticHandler
+};
+
+
 /**
  * @return a {@link Deserializer} function for the given languages (given as {@link ILanguageBase}s) that returns a {@link RootsWithIdMapping}.
+ * Deprecated:
  * @param languageBases the {@link ILanguageBase}s for (at least) all the languages used in the {@link LionWebJsonChunk} to deserialize, minus LionCore M3 and built-ins.
  * @param receiveDelta an optional {@link DeltaReceiver} that will be injected in all {@link INodeBase nodes} created.
  */
-export const nodeBaseDeserializerWithIdMapping = (languageBases: ILanguageBase[], receiveDelta?: DeltaReceiver): Deserializer<RootsWithIdMapping> => {
+function nodeBaseDeserializerWithIdMapping(languageBases: ILanguageBase[], receiveDelta?: DeltaReceiver): Deserializer<RootsWithIdMapping>;
+/**
+ * @param configuration a {@link DeserializerConfiguration configuration object} for the deserializer.
+ */
+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];
 
     const symbolTable = new MemoisingSymbolTable(languageBases.map(({language}) => language));
     const languageBaseFor = combinedLanguageBaseLookupFor(languageBases);
 
     return (
         serializationChunk,
-        dependentNodes = [],
-        idMapping,
-        propertyValueDeserializer = builtinPropertyValueDeserializer,
-        problemsHandler = defaultSimplisticHandler
+        idMapping
     ): RootsWithIdMapping => {
 
         const nodesToInstall: NodesToInstall[] = [];
@@ -145,10 +162,8 @@ export const nodeBaseDeserializerWithIdMapping = (languageBases: ILanguageBase[]
             )
         );
 
-        const dependentNodesById = byIdMap(dependentNodes);
-
         const lookupNodeById = (id: LionWebId): (INodeBase | undefined) =>
-            nodesById[id] ?? dependentNodesById[id] ?? idMapping?.tryFromId(id);
+            nodesById[id] ?? idMapping?.tryFromId(id);
 
         nodesToInstall.forEach(([node, feature, ids]) => {
             if (feature instanceof Containment) {
@@ -195,27 +210,34 @@ export const nodeBaseDeserializerWithIdMapping = (languageBases: ILanguageBase[]
         return {
             roots: Object.values(nodesById)
                 .filter(({parent}) => parent === undefined),
-            idMapping: new IdMapping({ ...nodesById, ...dependentNodesById })
+            idMapping: new IdMapping(nodesById)
         };
 
     };
-};
+}
 
 
 /**
  * @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:
  * @param languageBases the {@link ILanguageBase}s for (at least) all the languages used in the {@link LionWebJsonChunk} to deserialize, minus LionCore M3 and built-ins.
  * @param receiveDelta an optional {@link DeltaReceiver} that will be injected in all {@link INodeBase nodes} created.
  */
-export const nodeBaseDeserializer = (languageBases: ILanguageBase[], receiveDelta?: DeltaReceiver): Deserializer<INodeBase[]> => {
-    const deserializerWithIdMapping = nodeBaseDeserializerWithIdMapping(languageBases, receiveDelta);
+function nodeBaseDeserializer(languageBases: ILanguageBase[], receiveDelta?: DeltaReceiver): Deserializer<INodeBase[]>;
+/**
+ * @param configuration a {@link DeserializerConfiguration configuration object} for the deserializer.
+ */
+function nodeBaseDeserializer(configuration: FactoryConfiguration & DeserializerConfiguration): Deserializer<INodeBase[]>;
+function nodeBaseDeserializer(languageBasesOrConfiguration: ILanguageBase[] | (FactoryConfiguration & DeserializerConfiguration), receiveDelta?: DeltaReceiver): Deserializer<INodeBase[]> {
     return (
         serializationChunk,
-        dependentNodes,
-        idMapping,
-        propertyValueDeserializer = builtinPropertyValueDeserializer,
-        problemsHandler = defaultSimplisticHandler
+        idMapping
     ): INodeBase[] =>
-        deserializerWithIdMapping(serializationChunk, dependentNodes, idMapping, propertyValueDeserializer, problemsHandler).roots
+        Array.isArray(languageBasesOrConfiguration)
+            ? nodeBaseDeserializerWithIdMapping(languageBasesOrConfiguration, receiveDelta)(serializationChunk, idMapping).roots
+            : nodeBaseDeserializerWithIdMapping(languageBasesOrConfiguration)(serializationChunk, idMapping).roots
 }
 
+
+export { nodeBaseDeserializerWithIdMapping, nodeBaseDeserializer };
+

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

@@ -15,10 +15,11 @@
 // SPDX-FileCopyrightText: 2025 TRUMPF Laser SE and other contributors
 // SPDX-License-Identifier: Apache-2.0
 
-import { IdOrUnresolved, SingleRef, unresolved } from "@lionweb/core"
+import { SingleRef, unresolved } from "@lionweb/core"
 import { LionWebId } from "@lionweb/json"
 
-import { INodeBase } from "./index.js"
+import { INodeBase } from "./base-types.js"
+import { IdOrUnresolved } from "./references.js"
 
 
 /**
@@ -70,7 +71,7 @@ export class IdMapping {
     /**
      * Updates this {@link IdMapping} with the given `node` *and all its descendants* (recursively).
      */
-    updateWith= (node: INodeBase) => {
+    updateWith = (node: INodeBase) => {
         this.nodesById[node.id] = node;
         node.children   // recurse into all children
             .forEach((child) => this.updateWith(child));
@@ -87,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,8 +22,11 @@ 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";
+export { idFrom } from "./references.js";
 export { propertyValueSerializerWith, serializeNodeBases } from "./serializer.js";
 export { asTreeTextWith } from "./textualizer.js";
 export * from "./value-managers/index.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[] ];
 

package/src/{deltas/serialization/serializer-helpers.ts → references.ts}

@@ -15,21 +15,21 @@
 // SPDX-FileCopyrightText: 2025 TRUMPF Laser SE and other contributors
 // SPDX-License-Identifier: Apache-2.0
 
-import { builtinPropertyValueSerializer, IdOrUnresolved, SingleRef, unresolved } from "@lionweb/core"
-import { INodeBase } from "../../base-types.js"
-import { propertyValueSerializerWith } from "../../serializer.js"
+import { SingleRef, unresolved } from "@lionweb/core"
+import { LionWebId } from "@lionweb/json"
+
+import { INodeBase } from "./base-types.js"
+
 
 /**
- * A function that serializes the given value of the given {@link Property property},
- * using the same {@link builtinPropertyValueSerializer} instance as the {@link serializeNodeBases} function,
- * and the same treatment of enumeration values.
+ * A type that expresses a value is either an {@link LionWebId} or a value to indicate that resolution to a node previously failed.
  */
-export const defaultPropertyValueSerializer = propertyValueSerializerWith({ primitiveValueSerializer: builtinPropertyValueSerializer })
+export type IdOrUnresolved = LionWebId | typeof unresolved;
 
 
 /**
  * @return the ID of a given reference to a {@link INodeBase}, or {@link unresolved} if that reference was previously unresolved.
  */
 export const idFrom = (ref: SingleRef<INodeBase>): IdOrUnresolved =>
-    ref === unresolved ? null : ref.id
+    ref === unresolved ? unresolved : ref.id
 

package/dist/deltas/serialization/serializer-helpers.d.ts

@@ -1,15 +0,0 @@
-import { IdOrUnresolved, SingleRef } from "@lionweb/core";
-import { INodeBase } from "../../base-types.js";
-/**
- * A function that serializes the given value of the given {@link Property property},
- * using the same {@link builtinPropertyValueSerializer} instance as the {@link serializeNodeBases} function,
- * and the same treatment of enumeration values.
- */
-export declare const defaultPropertyValueSerializer: {
-    serializeValue: (value: unknown, property: import("@lionweb/core").Property) => string | null;
-};
-/**
- * @return the ID of a given reference to a {@link INodeBase}, or {@link unresolved} if that reference was previously unresolved.
- */
-export declare const idFrom: (ref: SingleRef<INodeBase>) => IdOrUnresolved;
-//# sourceMappingURL=serializer-helpers.d.ts.map

package/dist/deltas/serialization/serializer-helpers.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"serializer-helpers.d.ts","sourceRoot":"","sources":["../../../src/deltas/serialization/serializer-helpers.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAkC,cAAc,EAAE,SAAS,EAAc,MAAM,eAAe,CAAA;AACrG,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAG/C;;;;GAIG;AACH,eAAO,MAAM,8BAA8B;;CAA4F,CAAA;AAGvI;;GAEG;AACH,eAAO,MAAM,MAAM,GAAI,KAAK,SAAS,CAAC,SAAS,CAAC,KAAG,cACb,CAAA"}

package/dist/deltas/serialization/serializer-helpers.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"serializer-helpers.js","sourceRoot":"","sources":["../../../src/deltas/serialization/serializer-helpers.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,8BAA8B,EAA6B,UAAU,EAAE,MAAM,eAAe,CAAA;AAErG,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAA;AAEjE;;;;GAIG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,2BAA2B,CAAC,EAAE,wBAAwB,EAAE,8BAA8B,EAAE,CAAC,CAAA;AAGvI;;GAEG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,GAAyB,EAAkB,EAAE,CAChE,GAAG,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAA"}