@lionweb/class-core 0.7.0-beta.9 → 0.7.0

package/src/value-managers/references.ts

@@ -19,7 +19,12 @@ import { Reference, SingleRef } from "@lionweb/core"
 import { action, observable } from "mobx"
 
 import { INodeBase } from "../base-types.js"
-import { ReferenceAddedDelta, ReferenceDeletedDelta, ReferenceMovedInSameReferenceDelta, ReferenceReplacedDelta } from "../deltas/index.js"
+import {
+    EntryMovedInSameReferenceDelta,
+    ReferenceAddedDelta,
+    ReferenceChangedDelta,
+    ReferenceDeletedDelta
+} from "../deltas/index.js"
 import { checkIndex, FeatureValueManager } from "./base.js"
 
 
@@ -37,6 +42,7 @@ export abstract class ReferenceValueManager<T extends INodeBase> extends Feature
     /**
      * Adds the given target to the reference.
      * For a single-valued reference, this replaces an already-present target.
+     * **Note**: this method predominantly exists for the benefit of the deserializer and duplicator!
      */
     abstract addDirectly(newTarget: SingleRef<T> | undefined): void;
 
@@ -89,18 +95,18 @@ export class OptionalSingleReferenceValueManager<T extends INodeBase> extends Si
             return
         }
         if (newTarget === undefined) {
-            this.addDirectly(undefined);
+            this.setDirectly(undefined);
             if (oldTarget === undefined) {
                 // (nothing)
             } else {
                 this.emitDelta(() => new ReferenceDeletedDelta(this.container, this.reference, 0, oldTarget));
             }
         } else {
-            this.addDirectly(newTarget);
+            this.setDirectly(newTarget);
             if (oldTarget === undefined) {
                 this.emitDelta(() => new ReferenceAddedDelta(this.container, this.reference, 0, newTarget));
             } else {
-                this.emitDelta(() => new ReferenceReplacedDelta(this.container, this.reference, 0, oldTarget, newTarget));
+                this.emitDelta(() => new ReferenceChangedDelta(this.container, this.reference, 0, newTarget, oldTarget));
             }
         }
     }
@@ -132,11 +138,11 @@ export class RequiredSingleReferenceValueManager<T extends INodeBase> extends Si
         if (newTarget === undefined) {
             this.throwOnUnset();
         } else {
-            this.addDirectly(newTarget);
+            this.setDirectly(newTarget);
             if (oldTarget === undefined) {
                 this.emitDelta(() => new ReferenceAddedDelta(this.container, this.reference, 0, newTarget));
             } else {
-                this.emitDelta(() => new ReferenceReplacedDelta(this.container, this.reference, 0, oldTarget, newTarget));
+                this.emitDelta(() => new ReferenceChangedDelta(this.container, this.reference, 0, newTarget, oldTarget));
             }
         }
     }
@@ -158,7 +164,7 @@ export abstract class MultiReferenceValueManager<T extends INodeBase> extends Re
     }
 
     get(): SingleRef<T>[] {
-        return this.getDirectly().slice();
+        return this.getDirectly().slice();  // make defensive copy
     }
 
     isSet(): boolean {
@@ -194,6 +200,11 @@ export abstract class MultiReferenceValueManager<T extends INodeBase> extends Re
 
     abstract remove(targetToRemove: SingleRef<T>): void;
 
+    @action removeAtIndexDirectly(index: number): SingleRef<T> {
+        checkIndex(index, this.targets.length, false);
+        return this.targets.splice(index, 1)[0];
+    }
+
     @action moveDirectly(oldIndex: number, newIndex: number): SingleRef<T> | undefined {
         checkIndex(oldIndex, this.targets.length, false);
         checkIndex(newIndex, this.targets.length, false);
@@ -208,7 +219,16 @@ 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 ReferenceMovedInSameReferenceDelta(this.container, this.reference, oldIndex, newIndex, target));
+            this.emitDelta(() => new EntryMovedInSameReferenceDelta(this.container, this.reference, oldIndex, newIndex, target));
+        }
+    }
+
+    @action moveAndReplaceDirectly(oldIndex: number, newIndex: number) {
+        checkIndex(oldIndex, this.targets.length, false);
+        checkIndex(newIndex, this.targets.length, false);
+        if (oldIndex !== newIndex) {
+            this.targets.splice(newIndex, 1, this.targets[oldIndex]);
+            this.targets.splice(oldIndex, 1);
         }
     }
 

package/dist/deltas/handlers.d.ts

@@ -1,17 +0,0 @@
-import { IDelta } from "./base.js";
-/**
- * A type for functions that handle deltas.
- */
-export type DeltaHandler = (delta: IDelta) => void;
-export declare const collectingDeltaHandler: (printSerializations?: boolean) => [DeltaHandler, IDelta[]];
-/**
- * An interface for {@link DeltaHandler delta handlers} that can be switched on and off — “latching”.
- */
-export interface LatchingDeltaHandler extends DeltaHandler {
-    latch(emitDeltas: boolean): void;
-}
-/**
- * @return a latching version of the given {@link DeltaHandler delta handler}.
- */
-export declare const latching: (handleDelta: DeltaHandler) => LatchingDeltaHandler;
-//# sourceMappingURL=handlers.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/deltas/handlers.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AAIlC;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;AAEnD,eAAO,MAAM,sBAAsB,qCAAkC,CAAC,YAAY,EAAE,MAAM,EAAE,CAS3F,CAAC;AAGF;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,YAAY;IACtD,KAAK,CAAC,UAAU,EAAE,OAAO,GAAG,IAAI,CAAC;CACpC;AAED;;GAEG;AACH,eAAO,MAAM,QAAQ,gBAAiB,YAAY,KAAG,oBAcpD,CAAC"}

package/dist/deltas/handlers.js

@@ -1,43 +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 { serializeDelta } from "./serialization/index.js";
-export const collectingDeltaHandler = (printSerializations = false) => {
-    const deltas = [];
-    const handleDelta = (delta) => {
-        deltas.push(delta);
-        if (printSerializations) {
-            console.log(JSON.stringify(serializeDelta(delta), null, 4));
-        }
-    };
-    return [handleDelta, deltas];
-};
-/**
- * @return a latching version of the given {@link DeltaHandler delta handler}.
- */
-export const latching = (handleDelta) => {
-    let emitDeltas = false;
-    return Object.assign((delta) => {
-        if (emitDeltas) {
-            handleDelta(delta);
-        }
-    }, {
-        latch(emitDeltas_) {
-            emitDeltas = emitDeltas_;
-        },
-    });
-};
-//# sourceMappingURL=handlers.js.map

package/dist/deltas/handlers.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"handlers.js","sourceRoot":"","sources":["../../src/deltas/handlers.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;AAGtC,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAQzD,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,mBAAmB,GAAG,KAAK,EAA4B,EAAE;IAC5F,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,WAAW,GAAiB,CAAC,KAAK,EAAE,EAAE;QACxC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnB,IAAI,mBAAmB,EAAE,CAAC;YACtB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAChE,CAAC;IACL,CAAC,CAAC;IACF,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;AACjC,CAAC,CAAC;AAUF;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,WAAyB,EAAwB,EAAE;IACxE,IAAI,UAAU,GAAG,KAAK,CAAC;IACvB,OAAO,MAAM,CAAC,MAAM,CAChB,CAAC,KAAa,EAAE,EAAE;QACd,IAAI,UAAU,EAAE,CAAC;YACb,WAAW,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;IACL,CAAC,EACD;QACI,KAAK,CAAC,WAAoB;YACtB,UAAU,GAAG,WAAW,CAAC;QAC7B,CAAC;KACJ,CACJ,CAAC;AACN,CAAC,CAAC"}

package/src/deltas/handlers.ts

@@ -1,64 +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 { IDelta } from "./base.js"
-import { serializeDelta } from "./serialization/index.js"
-
-
-/**
- * A type for functions that handle deltas.
- */
-export type DeltaHandler = (delta: IDelta) => void;
-
-export const collectingDeltaHandler = (printSerializations = false): [DeltaHandler, IDelta[]] => {
-    const deltas: IDelta[] = [];
-    const handleDelta: DeltaHandler = (delta) => {
-        deltas.push(delta);
-        if (printSerializations) {
-            console.log(JSON.stringify(serializeDelta(delta), null, 4));
-        }
-    };
-    return [handleDelta, deltas];
-};
-
-
-/**
- * An interface for {@link DeltaHandler delta handlers} that can be switched on and off — “latching”.
- */
-export interface LatchingDeltaHandler extends DeltaHandler {
-    latch(emitDeltas: boolean): void;
-}
-
-/**
- * @return a latching version of the given {@link DeltaHandler delta handler}.
- */
-export const latching = (handleDelta: DeltaHandler): LatchingDeltaHandler => {
-    let emitDeltas = false;
-    return Object.assign(
-        (delta: IDelta) => {
-            if (emitDeltas) {
-                handleDelta(delta);
-            }
-        },
-        {
-            latch(emitDeltas_: boolean) {
-                emitDeltas = emitDeltas_;
-            },
-        },
-    );
-};
-