@lionweb/class-core 0.8.0-beta.6 → 0.8.0-beta.7

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

@@ -47,7 +47,6 @@ export type SerializedDelta =
     | ReferenceAddedSerializedDelta
     | ReferenceDeletedSerializedDelta
     | ReferenceChangedSerializedDelta
-    | CompositeSerializedDelta
     | NoOpSerializedDelta
     ;
 
@@ -249,7 +248,7 @@ export type ReferenceAddedSerializedDelta = {
     parent: LionWebId
     reference: LionWebJsonMetaPointer
     index: number
-    newTarget: IdOrNull
+    newReference: IdOrNull
 }
 
 export type ReferenceDeletedSerializedDelta = {
@@ -257,7 +256,7 @@ export type ReferenceDeletedSerializedDelta = {
     parent: LionWebId
     reference: LionWebJsonMetaPointer
     index: number
-    deletedTarget: IdOrNull
+    deletedReference: IdOrNull
 }
 
 export type ReferenceChangedSerializedDelta = {
@@ -265,13 +264,8 @@ export type ReferenceChangedSerializedDelta = {
     parent: LionWebId
     reference: LionWebJsonMetaPointer
     index: number
-    newTarget: IdOrNull
-    oldTarget: IdOrNull
-}
-
-export type CompositeSerializedDelta = {
-    kind: "Composite"
-    parts: SerializedDelta[]
+    newReference: IdOrNull
+    oldReference: IdOrNull
 }
 
 export type NoOpSerializedDelta = {

package/src/deltas/types.g.ts

@@ -20,6 +20,7 @@
 
 import {
     Containment,
+    Node,
     Property,
     Reference,
     SingleRef
@@ -254,7 +255,7 @@ export class ReferenceAddedDelta implements IDelta {
         public readonly parent: INodeBase,
         public readonly reference: Reference,
         public readonly index: number,
-        public readonly newTarget: SingleRef<INodeBase>
+        public readonly newReference: SingleRef<Node>
     ) {
     }
 }
@@ -264,7 +265,7 @@ export class ReferenceDeletedDelta implements IDelta {
         public readonly parent: INodeBase,
         public readonly reference: Reference,
         public readonly index: number,
-        public readonly deletedTarget: SingleRef<INodeBase>
+        public readonly deletedReference: SingleRef<Node>
     ) {
     }
 }
@@ -274,15 +275,8 @@ export class ReferenceChangedDelta implements IDelta {
         public readonly parent: INodeBase,
         public readonly reference: Reference,
         public readonly index: number,
-        public readonly newTarget: SingleRef<INodeBase>,
-        public readonly oldTarget: SingleRef<INodeBase>
-    ) {
-    }
-}
-
-export class CompositeDelta implements IDelta {
-    constructor(
-        public readonly parts: IDelta[]
+        public readonly newReference: SingleRef<Node>,
+        public readonly oldReference: SingleRef<Node>
     ) {
     }
 }

package/src/deserializer.ts

@@ -19,8 +19,8 @@ import {
     Classifier,
     consoleProblemReporter,
     Containment,
-    defaultLionWebVersion,
     Enumeration,
+    LionWebVersions,
     MemoisingSymbolTable,
     PrimitiveType,
     ProblemReporter,
@@ -61,7 +61,7 @@ export type RootsWithIdMapping = { roots: INodeBase[], idMapping: IdMapping };
  */
 export type DeserializerConfiguration = {
     // FIXME  parametrize (optionally) in LionWebVersion
-    /** Default: {@code lioncoreBuiltinsFacade.propertyValueDeserializer}. */
+    /** Default: `lioncoreBuiltinsFacade.propertyValueDeserializer`. */
     propertyValueDeserializer?: PropertyValueDeserializer,
     /** Default: {@link consoleProblemReporter}. */
     problemReporter?: ProblemReporter
@@ -83,8 +83,8 @@ function nodeBaseDeserializerWithIdMapping(languageBases: ILanguageBase[], recei
 function nodeBaseDeserializerWithIdMapping(configuration: FactoryConfiguration & DeserializerConfiguration): Deserializer<RootsWithIdMapping>;
 function nodeBaseDeserializerWithIdMapping(languageBasesOrConfiguration: ILanguageBase[] | (FactoryConfiguration & DeserializerConfiguration), mayBeReceiveDelta?: DeltaReceiver): Deserializer<RootsWithIdMapping> {
     const [languageBases, receiveDelta, propertyValueDeserializer, problemReporter] = Array.isArray(languageBasesOrConfiguration)
-        ? [languageBasesOrConfiguration, mayBeReceiveDelta, defaultLionWebVersion.builtinsFacade.propertyValueDeserializer, consoleProblemReporter]
-        : [languageBasesOrConfiguration.languageBases, languageBasesOrConfiguration.receiveDelta, languageBasesOrConfiguration.propertyValueDeserializer ?? defaultLionWebVersion.builtinsFacade.propertyValueDeserializer, languageBasesOrConfiguration.problemReporter ?? languageBasesOrConfiguration.problemsHandler ?? consoleProblemReporter];
+        ? [languageBasesOrConfiguration, mayBeReceiveDelta, LionWebVersions.v2023_1.builtinsFacade.propertyValueDeserializer, consoleProblemReporter]
+        : [languageBasesOrConfiguration.languageBases, languageBasesOrConfiguration.receiveDelta, languageBasesOrConfiguration.propertyValueDeserializer ?? LionWebVersions.v2023_1.builtinsFacade.propertyValueDeserializer, languageBasesOrConfiguration.problemReporter ?? languageBasesOrConfiguration.problemsHandler ?? consoleProblemReporter];
 
     const symbolTable = new MemoisingSymbolTable(languageBases.map(({language}) => language));
     const languageBaseFor = combinedLanguageBaseLookupFor(languageBases);

package/src/id-mapping.ts

@@ -15,17 +15,17 @@
 // SPDX-FileCopyrightText: 2025 TRUMPF Laser SE and other contributors
 // SPDX-License-Identifier: Apache-2.0
 
-import { referenceToSet, SingleRef } from "@lionweb/core"
+import { Node, referenceToSet, SingleRef } from "@lionweb/core"
 import { LionWebId } from "@lionweb/json"
 
-import { INodeBase } from "./base-types.js"
+import { INodeBase, NodeBase } from "./base-types.js"
 import { IdOrNull } from "./references.js"
 
 
 /**
- * Type def. for a (hash-)map {@link LionWebId ID} → {@link INodeBase}.
+ * Type def. for a (hash-)map {@link LionWebId ID} → {@link Node}.
  */
-type NodesById = { [id: LionWebId]: INodeBase }
+type NodesById = { [id: LionWebId]: Node }
 
 
 /**
@@ -39,13 +39,13 @@ export class IdMapping {
     constructor(nodesById: NodesById) {
         this.nodesById = {...nodesById};
     }
-    // TODO  consider using an instance of Map<Id, INodeBase> instead
+    // TODO  consider using an instance of Map<Id, Node> instead
 
     /**
-     * @return the {@link INodeBase node} with the given {@link LionWebId `id`}, or
+     * @return the {@link Node node} with the given {@link LionWebId `id`}, or
      * @throws an Error if no node with the given ID was registered.
      */
-    fromId = (id: LionWebId): INodeBase => {
+    fromId = (id: LionWebId): Node => {
         if (!(id in this.nodesById)) {
             throw new Error(`node with id=${id} not in ID mapping`);
         }
@@ -53,17 +53,30 @@ export class IdMapping {
     }
 
     /**
-     * @return the {@link INodeBase node} with the given {@link LionWebId `id`},
+     * @return the {@link INodeBase node} with the given {@link LionWebId `id`}, or
+     * @throws an Error if no node with the given ID was registered, or
+     * if the node is not a {@link INodeBase}.
+     */
+    nodeBaseFromId = (id: LionWebId): INodeBase => {
+        const node = this.fromId(id);
+        if (node instanceof NodeBase) {
+            return node;
+        }
+        throw new Error(`node with id=${id} is not a[n I]NodeBase`)
+    }
+
+    /**
+     * @return the {@link Node node} with the given {@link LionWebId `id`},
      * or `undefined` if no node with the given ID was registered.
      */
-    tryFromId = (id: LionWebId): (INodeBase | undefined) =>
+    tryFromId = (id: LionWebId): (Node | undefined) =>
         this.nodesById[id];
 
     /**
-     * @return the {@link INodeBase node} referenced from the given {@link LionWebId ID},
+     * @return the {@link Node node} referenced from the given {@link LionWebId ID},
      * or `unresolved` if `unresolved` was passed in or no node with the given ID was registered.
      */
-    fromRefId = (idOrNull: IdOrNull): SingleRef<INodeBase> =>
+    fromRefId = (idOrNull: IdOrNull): SingleRef<Node> =>
         idOrNull === null
             ? referenceToSet()
             : (this.nodesById[idOrNull] ?? referenceToSet());
@@ -71,10 +84,12 @@ export class IdMapping {
     /**
      * Updates this {@link IdMapping} with the given `node` *and all its descendants* (recursively).
      */
-    updateWith = (node: INodeBase) => {
+    updateWith = (node: Node) => {
         this.nodesById[node.id] = node;
-        node.children   // recurse into all children
-            .forEach((child) => this.updateWith(child));
+        if (node instanceof NodeBase) {
+            node.children   // recurse into all children
+                .forEach((child) => this.updateWith(child));
+        }
         // TODO  figure out when it's really necessary to call this, as it's potentially *very* expensive
     }
 

package/src/references.ts

@@ -15,11 +15,9 @@
 // SPDX-FileCopyrightText: 2025 TRUMPF Laser SE and other contributors
 // SPDX-License-Identifier: Apache-2.0
 
-import { isUnresolvedReference, SingleRef } from "@lionweb/core"
+import { isUnresolvedReference, Node, SingleRef } 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.
@@ -28,8 +26,8 @@ export type IdOrNull = LionWebId | null
 
 
 /**
- * @return the ID of a given reference to a {@link INodeBase}, or `null` if that reference was previously unresolved.
+ * @return the ID of a given reference to a {@link Node}, or `null` if that reference was previously unresolved.
  */
-export const idFrom = (ref: SingleRef<INodeBase>): IdOrNull =>
+export const idFrom = (ref: SingleRef<Node>): IdOrNull =>
     isUnresolvedReference(ref) ? null : ref.id
 

package/src/serializer.ts

@@ -16,12 +16,14 @@
 // SPDX-License-Identifier: Apache-2.0
 
 import {
+    allLionWebVersions,
     allSuperTypesOf,
     Containment,
-    defaultLionWebVersion,
     Enumeration,
     Feature,
     isUnresolvedReference,
+    LionWebVersions,
+    Node,
     PrimitiveType,
     Property,
     PropertyValueSerializer,
@@ -31,7 +33,7 @@ import {
     serializerWith
 } from "@lionweb/core"
 
-import { INodeBase, LionCore_builtinsBase } from "./index.js"
+import { INodeBase, LionCore_builtinsBase, NodeBase } from "./index.js"
 
 
 /**
@@ -55,7 +57,7 @@ export const getFeatureValue = (node: INodeBase, feature: Feature) => {
  * A {@link ResolveInfoDeducer} that works on {@link INodeBase}s.
  * *Note*: the {@link Reference} passed is not taken into account (yet).
  */
-const nodeBaseResolveInfoDeducer: ResolveInfoDeducer<INodeBase> = (node, _reference) => {
+const nodeBaseResolveInfoDeducer: ResolveInfoDeducer<Node> = (node, _reference) => {
     // TODO  put innards in separate function
     if ("name" in node) {
         // evaluating `node.name` might cause an error through FeatureValueManager.throwOnReadOfUnset:
@@ -66,12 +68,16 @@ const nodeBaseResolveInfoDeducer: ResolveInfoDeducer<INodeBase> = (node, _refere
             return undefined;
         }
     }
-    const allSupertypes = allSuperTypesOf(node.classifier);
-    if (allSupertypes.indexOf(defaultLionWebVersion.builtinsFacade.classifiers.inamed) > -1) {
-        return node.getPropertyValueManager(defaultLionWebVersion.builtinsFacade.features.inamed_name).getDirectly() as (string | undefined);
-    }
-    if (allSupertypes.indexOf(LionCore_builtinsBase.INSTANCE.INamed) > -1) {
-        return node.getPropertyValueManager(LionCore_builtinsBase.INSTANCE.INamed_name).getDirectly() as (string | undefined);
+    if (node instanceof NodeBase) {
+        const allSupertypes = allSuperTypesOf(node.classifier);
+        allLionWebVersions.forEach((lionWebVersion) => {
+            if (allSupertypes.indexOf(lionWebVersion.builtinsFacade.classifiers.inamed) > -1) {
+                return node.getPropertyValueManager(lionWebVersion.builtinsFacade.features.inamed_name).getDirectly() as (string | undefined);
+            }
+        })
+        if (allSupertypes.indexOf(LionCore_builtinsBase.INSTANCE.INamed) > -1) {
+            return node.getPropertyValueManager(LionCore_builtinsBase.INSTANCE.INamed_name).getDirectly() as (string | undefined);
+        }
     }
     return undefined;
 };
@@ -80,7 +86,7 @@ const nodeBaseResolveInfoDeducer: ResolveInfoDeducer<INodeBase> = (node, _refere
  * A {@link Reader} that works on/for {@link INodeBase}s specifically.
  * **Note** that this function is for internal use only!
  */
-export const nodeBaseReader: Reader<INodeBase> = {
+export const nodeBaseReader: Reader<INodeBase, Node> = {
     classifierOf: (node) => node.classifier,
     getFeatureValue,
     enumerationLiteralFrom: (encoding, enumeration) => {
@@ -109,7 +115,7 @@ type PropertyValueSerializerConfiguration = Partial<{
  * Unrecoverable issues are passed to the optional `reportIssue` argument, and
  */
 export const propertyValueSerializerWith = (configuration?: PropertyValueSerializerConfiguration) => {
-    const primitiveValueSerializer = configuration?.primitiveValueSerializer ?? defaultLionWebVersion.builtinsFacade.propertyValueSerializer
+    const primitiveValueSerializer = configuration?.primitiveValueSerializer ?? LionWebVersions.v2023_1.builtinsFacade.propertyValueSerializer
     const reportIssue = configuration?.reportIssue ?? ((message) => { throw new Error(message) })
     return {
         serializeValue: (value: unknown, property: Property) => {

package/src/textualizer.ts

@@ -21,6 +21,7 @@ import {
     Feature,
     isUnresolvedReference,
     Link,
+    Node,
     Property,
     Reference,
     UnresolvedReference
@@ -53,12 +54,29 @@ const asINodeBases = (value: INodeBaseOrNotThere | INodeBaseOrNotThere[]): INode
     return []
 }
 
+type NodeOrNotThere = Node | UnresolvedReference | undefined
+
+const asNodes = (value: NodeOrNotThere | NodeOrNotThere[]): Node[] => {
+    const isNode = (value: NodeOrNotThere): value is Node =>
+        !(value === undefined || isUnresolvedReference(value))
+
+    if (Array.isArray(value)) {
+        return value
+            .filter((subValue) => isNode(subValue))
+            .map((subValue) => subValue as Node)
+    }
+    if (isNode(value)) {
+        return [value]
+    }
+    return []
+}
+
 
 /**
  * @return a function that renders the roots of a given forest of {@link INodeBase nodes} in a textual tree-representation.
  * @param identificationFor a function that renders an identification for the given {@link INodeBase node} — typically its name or its ID.
  */
-export const asTreeTextWith = (identificationFor: (node: INodeBase) => string): ((nodes: INodeBase[]) => string) => {
+export const asTreeTextWith = (identificationFor: (node: Node) => string): ((nodes: INodeBase[]) => string) => {
 
     const asText = (node: INodeBase): Template => {
         const featureValueAsText = (feature: Feature) => {
@@ -87,7 +105,7 @@ export const asTreeTextWith = (identificationFor: (node: INodeBase) => string):
             }
             if (feature instanceof Reference) {
                 const valueManager= node.getReferenceValueManager(feature)
-                const references = asINodeBases(valueManager.getDirectly())
+                const references = asNodes(valueManager.getDirectly())
                 return [
                     `${feature.name} -> ${references.length === 0 ? nothing : references.map(identificationFor).join(", ")}`
                 ]

package/src/value-managers/references.ts

@@ -15,18 +15,18 @@
 // SPDX-FileCopyrightText: 2025 TRUMPF Laser SE and other contributors
 // SPDX-License-Identifier: Apache-2.0
 
-import { MultiRef, Reference, SingleRef } from "@lionweb/core"
+import { MultiRef, Node, Reference, SingleRef } from "@lionweb/core"
 import { action, observable } from "mobx"
 
 import { INodeBase } from "../base-types.js"
-import { CompositeDelta, ReferenceAddedDelta, ReferenceChangedDelta, ReferenceDeletedDelta } from "../deltas/index.js"
+import { ReferenceAddedDelta, ReferenceChangedDelta, ReferenceDeletedDelta } from "../deltas/index.js"
 import { checkIndex, FeatureValueManager } from "./base.js"
 
 
 /**
  * An instance manages the value of a particular reference feature on a particular instance of a classifier.
  */
-export abstract class ReferenceValueManager<T extends INodeBase> extends FeatureValueManager<Reference> {
+export abstract class ReferenceValueManager<T extends Node> extends FeatureValueManager<Reference> {
 
     get reference(): Reference {
         return this.feature;
@@ -44,7 +44,7 @@ export abstract class ReferenceValueManager<T extends INodeBase> extends Feature
 }
 
 
-export abstract class SingleReferenceValueManager<T extends INodeBase> extends ReferenceValueManager<T> {
+export abstract class SingleReferenceValueManager<T extends Node> extends ReferenceValueManager<T> {
 
     protected constructor(reference: Reference, container: INodeBase) {
         super(reference, container);
@@ -72,7 +72,7 @@ export abstract class SingleReferenceValueManager<T extends INodeBase> extends R
 }
 
 
-export class OptionalSingleReferenceValueManager<T extends INodeBase> extends SingleReferenceValueManager<T> {
+export class OptionalSingleReferenceValueManager<T extends Node> extends SingleReferenceValueManager<T> {
 
     constructor(reference: Reference, container: INodeBase) {
         super(reference, container);
@@ -109,7 +109,7 @@ export class OptionalSingleReferenceValueManager<T extends INodeBase> extends Si
 }
 
 
-export class RequiredSingleReferenceValueManager<T extends INodeBase> extends SingleReferenceValueManager<T> {
+export class RequiredSingleReferenceValueManager<T extends Node> extends SingleReferenceValueManager<T> {
 
     constructor(reference: Reference, container: INodeBase) {
         super(reference, container);
@@ -145,7 +145,7 @@ export class RequiredSingleReferenceValueManager<T extends INodeBase> extends Si
 }
 
 
-export abstract class MultiReferenceValueManager<T extends INodeBase> extends ReferenceValueManager<T> {
+export abstract class MultiReferenceValueManager<T extends Node> extends ReferenceValueManager<T> {
 
     protected constructor(reference: Reference, container: INodeBase) {
         super(reference, container);
@@ -214,10 +214,8 @@ export abstract class MultiReferenceValueManager<T extends INodeBase> extends Re
     @action move(oldIndex: number, newIndex: number) {
         const target = this.moveDirectly(oldIndex, newIndex);
         if (target !== undefined) {
-            this.emitDelta(() => new CompositeDelta([
-                new ReferenceDeletedDelta(this.container, this.reference, oldIndex, target),
-                new ReferenceAddedDelta(this.container, this.reference, newIndex < oldIndex ? newIndex : newIndex - 1, target)
-            ]));
+            this.emitDelta(() => new ReferenceDeletedDelta(this.container, this.reference, oldIndex, target));
+            this.emitDelta(() => new ReferenceAddedDelta(this.container, this.reference, newIndex < oldIndex ? newIndex : newIndex - 1, target));
         }
     }
 
@@ -233,7 +231,7 @@ export abstract class MultiReferenceValueManager<T extends INodeBase> extends Re
 }
 
 
-export class OptionalMultiReferenceValueManager<T extends INodeBase> extends MultiReferenceValueManager<T> {
+export class OptionalMultiReferenceValueManager<T extends Node> extends MultiReferenceValueManager<T> {
 
     constructor(reference: Reference, container: INodeBase) {
         super(reference, container);
@@ -250,7 +248,7 @@ export class OptionalMultiReferenceValueManager<T extends INodeBase> extends Mul
 }
 
 
-export class RequiredMultiReferenceValueManager<T extends INodeBase> extends MultiReferenceValueManager<T> {
+export class RequiredMultiReferenceValueManager<T extends Node> extends MultiReferenceValueManager<T> {
 
     constructor(reference: Reference, container: INodeBase) {
         super(reference, container);

package/dist/deltas/compositor.d.ts

@@ -1,51 +0,0 @@
-import { DeltaReceiver } from "../index.js";
-/**
- * A *delta compositor* is used to *aggregate* deltas as {@link CompositeDelta composite deltas}.
- *
- * Usage:
- * ```typescript
- * const compositor = new Compositor(downstreamReceiveDelta);
- * compositor.openComposite();
- * // ...
- * compositor.upstreamReceiveDelta(<delta>);
- * // ...
- * compositor.closeComposite();
- * ```
- */
-export declare class DeltaCompositor {
-    private readonly downstreamReceiveDelta;
-    private readonly maximumNestingDepth;
-    /**
-     * The {@link DeltaReceiver} implementation that either forwards to the given downstream delta handle
-     * or gathers deltas into composite deltas to forward to the downstream delta receiver later.
-     */
-    readonly upstreamReceiveDelta: DeltaReceiver;
-    /**
-     * An array of arrays of {@link IDelta deltas}, comprising a “stack”.
-     *
-     * Invariants:
-     *  - (I1) composite has been opened &hArr; `this.deltasInComposite !== undefined` / `Array.isArray(this.deltasInComposite)`
-     *  - (I2) this.deltasStack is either undefined or an array containing at least one array
-     */
-    private deltasStack;
-    /**
-     * @param downstreamReceiveDelta the {@link DeltaReceiver} that deltas get passed to.
-     * @param maximumNestingDepth the maximum depth that composites can be nested.
-     *  A maximum depth of e.g. 1 means that at most 1 composite can be open at any time.
-     */
-    constructor(downstreamReceiveDelta: DeltaReceiver, maximumNestingDepth?: number);
-    /**
-     * Opens a composite, meaning that all deltas passed to the {@link upstreamReceiveDelta} are gathered into a composite delta
-     * that gets forwarded to the downstream delta receiver as soon as the composite is closed.
-     *
-     * Composites can be nested, to the maximum depth configured through this class’ constructor,
-     * beyond which an error gets thrown.
-     */
-    openComposite: () => void;
-    /**
-     * Closes the current composite, producing the deltas gathered for this composite into a composite delta.
-     * Composites can be nested, and deltas only get forwarded to the downstream delta receiver after the top-level composite has been closed.
-     */
-    closeComposite: () => void;
-}
-//# sourceMappingURL=compositor.d.ts.map

package/dist/deltas/compositor.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"compositor.d.ts","sourceRoot":"","sources":["../../src/deltas/compositor.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAkB,aAAa,EAAU,MAAM,aAAa,CAAA;AAGnE;;;;;;;;;;;;GAYG;AACH,qBAAa,eAAe;IAsBZ,OAAO,CAAC,QAAQ,CAAC,sBAAsB;IAAiB,OAAO,CAAC,QAAQ,CAAC,mBAAmB;IApBxG;;;OAGG;IACH,QAAQ,CAAC,oBAAoB,EAAE,aAAa,CAAC;IAE7C;;;;;;OAMG;IACH,OAAO,CAAC,WAAW,CAAqC;IAExD;;;;OAIG;gBAC0B,sBAAsB,EAAE,aAAa,EAAmB,mBAAmB,GAAE,MAAiB;IAe3H;;;;;;OAMG;IACH,aAAa,QAAO,IAAI,CAQvB;IAED;;;OAGG;IACH,cAAc,QAAO,IAAI,CAYxB;CAEJ"}

package/dist/deltas/compositor.js

@@ -1,95 +0,0 @@
-// 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 { CompositeDelta } from "../index.js";
-/**
- * A *delta compositor* is used to *aggregate* deltas as {@link CompositeDelta composite deltas}.
- *
- * Usage:
- * ```typescript
- * const compositor = new Compositor(downstreamReceiveDelta);
- * compositor.openComposite();
- * // ...
- * compositor.upstreamReceiveDelta(<delta>);
- * // ...
- * compositor.closeComposite();
- * ```
- */
-export class DeltaCompositor {
-    /**
-     * @param downstreamReceiveDelta the {@link DeltaReceiver} that deltas get passed to.
-     * @param maximumNestingDepth the maximum depth that composites can be nested.
-     *  A maximum depth of e.g. 1 means that at most 1 composite can be open at any time.
-     */
-    constructor(downstreamReceiveDelta, maximumNestingDepth = Infinity) {
-        this.downstreamReceiveDelta = downstreamReceiveDelta;
-        this.maximumNestingDepth = maximumNestingDepth;
-        /**
-         * An array of arrays of {@link IDelta deltas}, comprising a “stack”.
-         *
-         * Invariants:
-         *  - (I1) composite has been opened &hArr; `this.deltasInComposite !== undefined` / `Array.isArray(this.deltasInComposite)`
-         *  - (I2) this.deltasStack is either undefined or an array containing at least one array
-         */
-        this.deltasStack = undefined;
-        /**
-         * Opens a composite, meaning that all deltas passed to the {@link upstreamReceiveDelta} are gathered into a composite delta
-         * that gets forwarded to the downstream delta receiver as soon as the composite is closed.
-         *
-         * Composites can be nested, to the maximum depth configured through this class’ constructor,
-         * beyond which an error gets thrown.
-         */
-        this.openComposite = () => {
-            if (this.deltasStack === undefined) {
-                this.deltasStack = []; // ==> (I1) + 1st half of (I2)
-            }
-            if (this.deltasStack.length >= this.maximumNestingDepth) {
-                throw new Error(`attempt occurred to start a nested composition exceeding the maximum nesting depth`);
-            }
-            this.deltasStack.push([]); // ==> 2nd half of (I2)
-        };
-        /**
-         * Closes the current composite, producing the deltas gathered for this composite into a composite delta.
-         * Composites can be nested, and deltas only get forwarded to the downstream delta receiver after the top-level composite has been closed.
-         */
-        this.closeComposite = () => {
-            if (this.deltasStack === undefined) {
-                throw new Error(`attempt occurred to finish a composite without one being started`);
-            }
-            const parts = this.deltasStack.pop(); // is an array because of (I2)
-            if (this.deltasStack.length === 0) { // last array popped from stack
-                this.deltasStack = undefined; // maintain (I2)
-            }
-            if (parts.length > 0) {
-                this.upstreamReceiveDelta(new CompositeDelta(parts));
-            }
-        };
-        if (maximumNestingDepth !== Infinity && (!Number.isInteger(maximumNestingDepth) || maximumNestingDepth < 0)) {
-            throw new Error(`maximum nesting depth must be a non-negative integer`);
-        }
-        this.upstreamReceiveDelta = (delta) => {
-            if (this.deltasStack === undefined) {
-                // pass on immediately:
-                this.downstreamReceiveDelta(delta);
-            }
-            else {
-                // store for later:
-                this.deltasStack[this.deltasStack.length - 1].push(delta); // (I2)
-            }
-        };
-    }
-}
-//# sourceMappingURL=compositor.js.map

package/dist/deltas/compositor.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"compositor.js","sourceRoot":"","sources":["../../src/deltas/compositor.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,cAAc,EAAyB,MAAM,aAAa,CAAA;AAGnE;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,eAAe;IAiBxB;;;;OAIG;IACH,YAA6B,sBAAqC,EAAmB,sBAA8B,QAAQ;QAA9F,2BAAsB,GAAtB,sBAAsB,CAAe;QAAmB,wBAAmB,GAAnB,mBAAmB,CAAmB;QAd3H;;;;;;WAMG;QACK,gBAAW,GAA2B,SAAS,CAAC;QAsBxD;;;;;;WAMG;QACH,kBAAa,GAAG,GAAS,EAAE;YACvB,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;gBACjC,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC,CAAE,8BAA8B;YAC1D,CAAC;YACD,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,IAAI,IAAI,CAAC,mBAAmB,EAAE,CAAC;gBACtD,MAAM,IAAI,KAAK,CAAC,oFAAoF,CAAC,CAAA;YACzG,CAAC;YACD,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAE,uBAAuB;QACvD,CAAC,CAAA;QAED;;;WAGG;QACH,mBAAc,GAAG,GAAS,EAAE;YACxB,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;gBACjC,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;YACxF,CAAC;YAED,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,EAAG,CAAC,CAAE,8BAA8B;YACtE,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC,CAAI,+BAA+B;gBACnE,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC,CAAG,gBAAgB;YACpD,CAAC;YACD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACnB,IAAI,CAAC,oBAAoB,CAAC,IAAI,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC;YACzD,CAAC;QACL,CAAC,CAAA;QA/CG,IAAI,mBAAmB,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,mBAAmB,CAAC,IAAI,mBAAmB,GAAG,CAAC,CAAC,EAAE,CAAC;YAC1G,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;QAC5E,CAAC;QACD,IAAI,CAAC,oBAAoB,GAAG,CAAC,KAAK,EAAE,EAAE;YAClC,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;gBACjC,uBAAuB;gBACvB,IAAI,CAAC,sBAAsB,CAAC,KAAK,CAAC,CAAC;YACvC,CAAC;iBAAM,CAAC;gBACJ,mBAAmB;gBACnB,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAE,OAAO;YACvE,CAAC;QACL,CAAC,CAAC;IACN,CAAC;CAqCJ"}