@lionweb/json-diff 0.7.0-beta.17 → 0.7.0-beta.19

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@lionweb/json-diff",
-    "version": "0.7.0-beta.17",
+    "version": "0.7.0-beta.19",
     "description": "Find diff between LionWeb JSON chunks",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",
@@ -27,8 +27,8 @@
         "release": "npm publish"
     },
     "dependencies": {
-        "@lionweb/json": "0.7.0-beta.17",
-        "@lionweb/json-utils": "0.7.0-beta.17",
-        "@lionweb/ts-utils": "0.7.0-beta.17"
+        "@lionweb/json": "0.7.0-beta.19",
+        "@lionweb/json-utils": "0.7.0-beta.19",
+        "@lionweb/ts-utils": "0.7.0-beta.19"
     }
 }

package/src/DiffResult.ts

@@ -0,0 +1,21 @@
+import { Change } from "./changes/Change.js"
+
+export class DiffResult {
+    changes: Change[] = []
+
+    change(issue: Change) {
+        this.changes.push(issue)
+    }
+
+    reset() {
+        this.changes = []
+    }
+
+    hasChanges(): boolean {
+        return this.changes.length !== 0
+    }
+
+    asStringArray(): string[] {
+        return this.changes.map(ch => ch.changeMsg())
+    }
+}

package/src/LionWebJsonDiff.ts

@@ -0,0 +1,309 @@
+import {
+    isEqualMetaPointer,
+    isEqualReferenceTarget,
+    LionWebJsonChunk,
+    LionWebJsonContainment,
+    LionWebJsonNode,
+    LionWebJsonProperty,
+    LionWebJsonReference,
+    LionWebJsonReferenceTarget,
+    LionWebJsonUsedLanguage
+} from "@lionweb/json"
+import { ChunkUtils, JsonContext, NodeUtils } from "@lionweb/json-utils"
+import { asMinimalJsonString } from "@lionweb/ts-utils"
+import { Change, GenericChange, Missing } from "./changes/Change.js"
+import { LanguageAdded, LanguageRemoved, NodeAdded, NodeRemoved, SerializationFormatChange } from "./changes/ChunkChange.js"
+import { ChildAdded, ChildOrderChanged, ChildRemoved } from "./changes/ContainmentChange.js"
+import { AnnotationAdded, AnnotationOrderChanged, AnnotationRemoved, TargetAdded, TargetOrderChanged, TargetRemoved } from "./changes/index.js"
+import { NodeClassifierChanged, ParentChanged } from "./changes/NodeChange.js"
+import { PropertyValueChanged } from "./changes/PropertyChange.js"
+import { DiffResult } from "./DiffResult.js"
+
+/**
+ * Comparing LionWeb JSON chunks and find all differences
+ */
+export class LionWebJsonDiff {
+    diffResult = new DiffResult()
+
+    constructor() {}
+
+    change(change: Change): void {
+        this.diffResult.change(change)
+    }
+
+    diff(ctx: JsonContext, msg: string) {
+        const change = new GenericChange(ctx, msg)
+        this.diffResult.change(change)
+    }
+
+    /**
+     * Compare two LwNode objects and return their difference
+     * @param beforeNode
+     * @param afterNode
+     */
+    diffLwNode(ctx: JsonContext, beforeNode: LionWebJsonNode, afterNode: LionWebJsonNode): void {
+        if (!isEqualMetaPointer(beforeNode.classifier, afterNode.classifier)) {
+            this.change(new NodeClassifierChanged(ctx.concat("classifier"), beforeNode, beforeNode.classifier, afterNode.classifier))
+        }
+        if (beforeNode.parent !== afterNode.parent) {
+            this.change(new ParentChanged(ctx, beforeNode, beforeNode.parent, afterNode.parent))
+        }
+        // Find diff between previous and next properties
+        beforeNode.properties.forEach((beforeProperty: LionWebJsonProperty, index: number) => {
+            const afterProperty = NodeUtils.findProperty(afterNode, beforeProperty.property)
+            if (afterProperty === undefined) {
+                this.change(
+                    new PropertyValueChanged(
+                        ctx.concat("properties", index),
+                        beforeNode.id,
+                        beforeProperty.property,
+                        beforeProperty.value,
+                        null,
+                        Missing.MissingAfter
+                    ),
+                )
+            } else {
+                this.diffLwProperty(ctx.concat("properties", index), beforeNode, beforeProperty, afterProperty)
+            }
+        })
+        afterNode.properties.forEach((afterProperty: LionWebJsonProperty, index: number) => {
+            const beforeProperty = NodeUtils.findProperty(beforeNode, afterProperty.property)
+            if (beforeProperty === undefined) {
+                this.change(
+                    new PropertyValueChanged(
+                        ctx.concat("properties", index),
+                        beforeNode.id,
+                        afterProperty.property,
+                        null,
+                        afterProperty.value,
+                        Missing.MissingBefore
+                    ),
+                )
+            }
+            // no else, if the property exists in both nodes, the diff has been claculated in the loop before this one
+        })
+        beforeNode.containments.forEach((beforeContainment: LionWebJsonContainment, index: number) => {
+            const beforeKey = beforeContainment.containment.key
+            const afterContainment = NodeUtils.findChild(afterNode, beforeKey)
+            if (afterContainment === undefined) {
+                // NB No containment is considered equivalent to a containment with empty _children_
+                if (beforeContainment.children.length !== 0) {
+                    beforeContainment.children.forEach(childId => {
+                        this.change(new ChildRemoved(ctx.concat("containments", index), beforeNode, beforeContainment.containment, afterContainment, childId, Missing.MissingAfter))
+                    })
+                }
+            } else {
+                this.diffContainment(ctx.concat("containments", index), beforeNode, beforeContainment, afterContainment)
+            }
+        })
+        afterNode.containments.forEach((afterContainment: LionWebJsonContainment, index: number) => {
+            const afterKey = afterContainment.containment.key
+            const beforeContainment = NodeUtils.findChild(beforeNode, afterKey)
+            if (beforeContainment === undefined) {
+                if (afterContainment.children.length !== 0) {
+                    afterContainment.children.forEach(childId => {
+                        this.change(new ChildAdded(ctx.concat("containments", index), afterNode, afterContainment.containment, afterContainment, childId, Missing.MissingBefore))
+                    })
+                }
+            }
+            // No else, has already been done
+        })
+        beforeNode.references.forEach((beforeReference: LionWebJsonReference, index: number) => {
+            const afterReference = NodeUtils.findReference(afterNode, beforeReference.reference)
+            if (afterReference === undefined) {
+                if (beforeReference.targets.length !== 0) {
+                    beforeReference.targets.forEach(target => {
+                        this.change(new TargetRemoved(ctx.concat("references", index), afterNode, beforeReference, afterReference, target, Missing.MissingAfter))
+                    })
+                }
+            } else {
+                this.diffLwReference(ctx.concat("references", index), beforeNode, beforeReference, afterReference)
+            }
+        })
+        afterNode.references.forEach((afterReference: LionWebJsonReference, index: number) => {
+            const beforeReference = NodeUtils.findReference(afterNode, afterReference.reference)
+            if (beforeReference === undefined) {
+                if (afterReference.targets.length !== 0) {
+                    afterReference.targets.forEach(target => {
+                        this.change(new TargetAdded(ctx.concat("references", index), afterNode, beforeReference, afterReference, target, Missing.MissingBefore))
+                    })
+                }
+            }
+        })
+        if (beforeNode.annotations !== undefined && afterNode.annotations !== undefined) {
+            let annotationDiffFound = false
+            beforeNode.annotations.forEach((beforeAnn: string, index: number) => {
+                if (!afterNode.annotations.includes(beforeAnn)) {
+                    annotationDiffFound = true
+                    this.change(new AnnotationRemoved(ctx, beforeNode, afterNode, beforeAnn, index))
+                }
+            })
+            afterNode.annotations.forEach((afterAnn: string, index: number) => {
+                if (!beforeNode.annotations.includes(afterAnn)) {
+                    annotationDiffFound = true
+                    this.change(new AnnotationAdded(ctx, beforeNode, afterNode, afterAnn, index))
+                }
+            })
+            if (!annotationDiffFound) {
+                for (let i: number = 0; i < afterNode.annotations.length; i++) {
+                    if (afterNode.annotations[i] !== beforeNode.annotations[i]) {
+                        this.change(new AnnotationOrderChanged(ctx.concat("annotations"), beforeNode, afterNode, "", i))
+                        break
+                    }
+                }
+            }
+        }
+    }
+
+    diffLwChunk(beforeChunk: LionWebJsonChunk, afterChunk: LionWebJsonChunk): void {
+        const ctx = new JsonContext(null, ["$"])
+        if (beforeChunk.serializationFormatVersion !== afterChunk.serializationFormatVersion) {
+            this.change(
+                new SerializationFormatChange(
+                    ctx.concat("serializationFormatVersion"),
+                    beforeChunk.serializationFormatVersion,
+                    afterChunk.serializationFormatVersion,
+                ),
+            )
+        }
+        beforeChunk.languages.forEach((beforeLanguage: LionWebJsonUsedLanguage, index: number) => {
+            const afterLanguage = ChunkUtils.findLwUsedLanguage(afterChunk, beforeLanguage.key)
+            if (afterLanguage === null) {
+                this.change(new LanguageRemoved(ctx.concat("languages", index), beforeLanguage))
+            } else {
+                this.diffLwUsedLanguage(ctx.concat("languages", index), beforeLanguage, afterLanguage)
+            }
+        })
+        afterChunk.languages.forEach((afterLanguage: LionWebJsonUsedLanguage, index: number) => {
+            const beforeLanguage = ChunkUtils.findLwUsedLanguage(beforeChunk, afterLanguage.key)
+            if (beforeLanguage === null) {
+                this.change(new LanguageAdded(ctx.concat("languages", index), afterLanguage))
+            }
+        })
+        beforeChunk.nodes.forEach((beforeNode: LionWebJsonNode, index: number) => {
+            const beforeId = beforeNode.id
+            const afterNode = ChunkUtils.findNode(afterChunk, beforeId)
+            const newCtx = ctx.concat("nodes", index)
+            if (afterNode === null || afterNode === undefined) {
+                this.change(new NodeRemoved(ctx, beforeNode))
+            } else {
+                this.diffLwNode(newCtx, beforeNode, afterNode)
+            }
+        })
+        afterChunk.nodes.forEach((afterNode: LionWebJsonNode, index: number) => {
+            const afterId = afterNode.id
+            const beforeNode = ChunkUtils.findNode(beforeChunk, afterId)
+            if (beforeNode === null) {
+                this.change(new NodeAdded(ctx.concat("nodes", index), afterNode))
+            }
+        })
+    }
+
+    diffContainment(
+        ctx: JsonContext,
+        node: LionWebJsonNode,
+        beforeContainment: LionWebJsonContainment,
+        afterContainment: LionWebJsonContainment,
+    ): void {
+        if (!isEqualMetaPointer(beforeContainment.containment, afterContainment.containment)) {
+            console.error("diffContainment: MetaPointers of containments should be identical")
+            this.diff(
+                ctx,
+                `Containment Object has concept ${asMinimalJsonString(beforeContainment.containment)} vs ${JSON.stringify(
+                    afterContainment.containment,
+                )}`,
+            )
+        }
+        // Check whether children exist in both objects (two for loops)
+        // TODO Also check for the order that can be changed!!!
+        let changeFound = false
+        for (const childId of beforeContainment.children) {
+            if (!afterContainment.children.includes(childId)) {
+                changeFound = true
+                this.change(new ChildRemoved(ctx, node, beforeContainment.containment, afterContainment, childId))
+            }
+        }
+        for (const childId of afterContainment.children) {
+            if (!beforeContainment.children.includes(childId)) {
+                changeFound = true
+                this.change(new ChildAdded(ctx, node, beforeContainment.containment, afterContainment, childId))
+            }
+        }
+        if (!changeFound) {
+            for (let i: number = 0; i < afterContainment.children.length; i++) {
+                if (afterContainment.children[i] !== beforeContainment.children[i]) {
+                    this.change(new ChildOrderChanged(ctx.concat("children"), node, afterContainment.containment, afterContainment, ""))
+                    break
+                }
+            }
+        }
+    }
+
+    diffLwReference(ctx: JsonContext, node: LionWebJsonNode, beforeRef: LionWebJsonReference, afterRef: LionWebJsonReference): void {
+        if (!isEqualMetaPointer(beforeRef.reference, afterRef.reference)) {
+            console.error("diffContainment: MetaPointers of references should be identical")
+            this.diff(ctx, `Reference has concept ${asMinimalJsonString(beforeRef.reference)} vs ${asMinimalJsonString(afterRef.reference)}`)
+        }
+        let diffFound = false;
+        beforeRef.targets.forEach((beforeTarget: LionWebJsonReferenceTarget, index: number) => {
+            const afterTarget = NodeUtils.findReferenceTarget(afterRef.targets, beforeTarget)
+            if (afterTarget === undefined) {
+                this.change(new TargetRemoved(ctx.concat("targets", index), node, beforeRef, afterRef, beforeTarget))
+                diffFound = true
+            } else {
+                if (!isEqualReferenceTarget(beforeTarget, afterTarget)) {
+                    this.diff(
+                        ctx.concat("targets", index),
+                        `ERROR: reference target ${asMinimalJsonString(beforeTarget)} vs ${asMinimalJsonString(afterTarget)}`,
+                    )
+                }
+            }
+        })
+        afterRef.targets.forEach((afterTarget: LionWebJsonReferenceTarget, index: number) => {
+            const beforeTarget = NodeUtils.findReferenceTarget(beforeRef.targets, afterTarget)
+            if (beforeTarget === undefined) {
+                this.change(new TargetAdded(ctx.concat("targets", index), node, beforeRef, afterRef, afterTarget))
+                diffFound = true
+            } else {
+                if (!isEqualReferenceTarget(beforeTarget, afterTarget)) {
+                    this.diff(
+                        ctx.concat("targets", index),
+                        `ERROR: reference target ${asMinimalJsonString(beforeTarget)} vs ${asMinimalJsonString(afterTarget)}`,
+                    )
+                }
+            }
+        })
+        if (!diffFound) {
+            for (let i: number = 0; i < beforeRef.targets.length; i++) {
+                if (!isEqualReferenceTarget(beforeRef.targets[i], afterRef.targets[i])) {
+                    this.change(new TargetOrderChanged(ctx.concat("targets"), node, beforeRef, afterRef, beforeRef.targets[i]))
+                    break
+                }
+            }
+        }
+    }
+
+    private diffLwUsedLanguage(ctx: JsonContext, obj1: LionWebJsonUsedLanguage, obj2: LionWebJsonUsedLanguage) {
+        if (obj1.key !== obj2.key || obj1.version !== obj2.version) {
+            this.diff(ctx, `Different used languages ${asMinimalJsonString(obj1)} vs ${asMinimalJsonString(obj2)}`)
+        }
+    }
+
+    private diffLwProperty(
+        ctx: JsonContext,
+        node: LionWebJsonNode,
+        beforeProperty: LionWebJsonProperty,
+        afterProperty: LionWebJsonProperty,
+    ) {
+        if (!isEqualMetaPointer(beforeProperty.property, afterProperty.property)) {
+            console.error("diffContainment: MetaPointers of properties should be identical")
+            this.diff(
+                ctx,
+                `Property Object has concept ${asMinimalJsonString(beforeProperty.property)} vs ${asMinimalJsonString(afterProperty.property)}`,
+            )
+        }
+        if (beforeProperty.value !== afterProperty.value) {
+            this.change(new PropertyValueChanged(ctx, node.id, beforeProperty.property, beforeProperty.value, afterProperty.value))
+        }
+    }
+}

package/src/changes/Change.ts

@@ -0,0 +1,76 @@
+import { JsonContext } from "@lionweb/json-utils"
+
+export type ChangeType =
+    | "GenericChange"
+    | "NodeRemoved"
+    | "NodeAdded"
+    | "ChildRemoved"
+    | "ChildAdded"
+    | "ParentChanged"
+    | "PropertyValueChanged"
+    | "SerializationFormatChange"
+    | "PropertyRemoved"
+    | "PropertyAdded"
+    | "NodeClassifierChanged"
+    | "ContainmentAdded"
+    | "ContainmentRemoved"
+    | "LanguageRemoved"
+    | "LanguageAdded"
+    | "TargetAdded"
+    | "TargetRemoved"
+    | "ReferenceRemoved"
+    | "ReferenceAdded"
+    | "AnnotationRemoved"
+    | "AnnotationAdded"
+    | "ChildOrderChanged"
+    | "AnnotationOrderChanged"
+    | "TargetOrderChanged"
+
+/**
+ * Additionbal property in property, contauinment and reference changes to state
+ * that the whole property/ containment / reference definition is missing.
+ */
+export enum Missing {
+    /**
+     * Both before and after have a definition for the property / containment / reference
+     */
+    NotMissing,
+    /**
+     * The definition is missing _before_ for the property / containment / reference
+     */
+    MissingBefore,
+    /**
+     * The definition is missing _after_ for the property / containment / reference
+     */
+    MissingAfter
+}
+
+export abstract class Change {
+    abstract readonly changeType: ChangeType
+    context: JsonContext
+
+    constructor(context: JsonContext) {
+        this.context = context
+    }
+
+    protected abstract msg(): string
+
+    public changeMsg(): string {
+        return `${this.changeType}: ${this.msg()} at ${this.context.toString()} `
+    }
+}
+
+export class GenericChange extends Change {
+    readonly changeType = "GenericChange"
+
+    constructor(
+        context: JsonContext,
+        protected message: string
+    ) {
+        super(context)
+    }
+
+    protected msg(): string {
+        return this.message
+    }
+}

package/src/changes/ChunkChange.ts

@@ -0,0 +1,68 @@
+import { LionWebJsonNode, LionWebJsonUsedLanguage } from "@lionweb/json"
+import { JsonContext } from "@lionweb/json-utils"
+import { Change } from "./Change.js"
+
+export abstract class ChunkChange extends Change {
+    constructor(public context: JsonContext) {
+        super(context)
+    }
+}
+
+export class SerializationFormatChange extends ChunkChange {
+    readonly changeType = "SerializationFormatChange"
+
+    constructor(
+        public context: JsonContext,
+        protected original: string,
+        protected newValue: string
+    ) {
+        super(context)
+    }
+
+    protected msg = () => `Serialization versions do not match: ${this.original} vs ${this.newValue}`
+}
+
+export class NodeRemoved extends ChunkChange {
+    readonly changeType = "NodeRemoved"
+
+    constructor(
+        public context: JsonContext,
+        public node: LionWebJsonNode
+    ) {
+        super(context)
+    }
+
+    protected msg = () => `Node ${this.node.id} is removed`
+}
+
+export class NodeAdded extends ChunkChange {
+    readonly changeType = "NodeAdded"
+
+    constructor(
+        public context: JsonContext,
+        public node: LionWebJsonNode
+    ) {
+        super(context)
+    }
+
+    protected msg = () => `Node ${this.node.id} is added`
+}
+
+export abstract class LanguageChange extends ChunkChange {
+    constructor(
+        public context: JsonContext,
+        public language: LionWebJsonUsedLanguage
+    ) {
+        super(context)
+    }
+}
+
+export class LanguageRemoved extends LanguageChange {
+    readonly changeType = "LanguageRemoved"
+    protected msg = () => `Language with  key ${this.language.key} and version ${this.language.version} is removed`
+}
+
+export class LanguageAdded extends LanguageChange {
+    readonly changeType = "LanguageAdded"
+    protected msg = () => `Language with  key ${this.language.key} and version ${this.language.version} is added`
+}

package/src/changes/ContainmentChange.ts

@@ -0,0 +1,31 @@
+import { LionWebId, LionWebJsonContainment, LionWebJsonMetaPointer, LionWebJsonNode } from "@lionweb/json"
+import { JsonContext } from "@lionweb/json-utils"
+import { Change, Missing } from "./Change.js"
+
+export abstract class ContainmentChange extends Change {
+    constructor(
+        public context: JsonContext,
+        public parentNode: LionWebJsonNode,
+        public containment: LionWebJsonMetaPointer,
+        public afterContainment: LionWebJsonContainment | undefined,
+        public childId: LionWebId,
+        public missing = Missing.NotMissing
+    ) {
+        super(context)
+    }
+}
+
+export class ChildAdded extends ContainmentChange {
+    readonly changeType = "ChildAdded"
+    protected msg = () => `Node "${this.parentNode.id}" added child "${this.childId}" to containment ${this.containment.key}`
+}
+
+export class ChildRemoved extends ContainmentChange {
+    readonly changeType = "ChildRemoved"
+    protected msg = () => `Node "${this.parentNode.id}" removed child "${this.childId}" from containment "${this.containment.key}"`
+}
+
+export class ChildOrderChanged extends ContainmentChange {
+    readonly changeType = "ChildOrderChanged"
+    protected msg = () => `Node "${this.parentNode.id}" changed order of children in containment "${this.containment.key}"`
+}

package/src/changes/NodeChange.ts

@@ -0,0 +1,62 @@
+import { LionWebId, LionWebJsonMetaPointer, LionWebJsonNode } from "@lionweb/json"
+import { JsonContext } from "@lionweb/json-utils"
+import { Change, ChangeType } from "./Change.js"
+
+export class NodeClassifierChanged extends Change {
+    readonly changeType: ChangeType = "NodeClassifierChanged"
+
+    constructor(
+        public context: JsonContext,
+        public node: LionWebJsonNode,
+        public oldClassifier: LionWebJsonMetaPointer,
+        public newClassifier: LionWebJsonMetaPointer
+    ) {
+        super(context)
+    }
+
+    protected msg = () => `Object ${this.node.id} has classifier changed from ${this.oldClassifier.key} to ${this.newClassifier.key}`
+}
+
+export class ParentChanged extends Change {
+    readonly changeType = "ParentChanged"
+
+    constructor(
+        public context: JsonContext,
+        public node: LionWebJsonNode,
+        public beforeParentId: LionWebId | null,
+        public afterParentId: LionWebId | null
+    ) {
+        super(context)
+    }
+
+    protected msg = () => `Node "${this.node.id}" changed parent from "${this.beforeParentId}" to "${this.afterParentId}`
+}
+
+export abstract class AnnotationChange extends Change {
+    constructor(
+        ctx: JsonContext,
+        public nodeBefore: LionWebJsonNode,
+        public nodeAfter: LionWebJsonNode,
+        public annotationId: LionWebId,
+        public index: number
+    ) {
+        super(ctx)
+    }
+}
+
+export class AnnotationRemoved extends AnnotationChange {
+    readonly changeType = "AnnotationRemoved"
+
+    protected msg = () => `Node "${this.nodeBefore.id}" removed annotation "${this.annotationId}"`
+}
+
+export class AnnotationAdded extends AnnotationChange {
+    readonly changeType = "AnnotationAdded"
+
+    protected msg = () => `Node "${this.nodeAfter.id}" added annotation "${this.annotationId}"`
+}
+
+export class AnnotationOrderChanged extends AnnotationChange {
+    readonly changeType = "AnnotationOrderChanged"
+    protected msg = () => `Node "${this.nodeAfter.id}" changed order of annotations`
+}

package/src/changes/PropertyChange.ts

@@ -0,0 +1,36 @@
+import { LionWebId, LionWebJsonMetaPointer, LionWebJsonNode } from "@lionweb/json"
+import { JsonContext } from "@lionweb/json-utils"
+import { asMinimalJsonString } from "@lionweb/ts-utils"
+import { Change, Missing } from "./Change.js"
+
+export abstract class PropertyChange extends Change {
+    constructor(
+        public context: JsonContext,
+        public nodeId: LionWebId,
+        public property: LionWebJsonMetaPointer,
+        public oldValue: string | null,
+        public newValue: string | null,
+        public missing: Missing = Missing.NotMissing
+    ) {
+        super(context)
+    }
+}
+
+export class PropertyValueChanged extends PropertyChange {
+    readonly changeType = "PropertyValueChanged"
+    protected msg = () =>
+        `Node "${this.nodeId} changed value of property "${this.property.key}" from "${this.oldValue}" to "${this.newValue}"`
+}
+
+export class PropertyAdded extends Change {
+    readonly changeType = "PropertyAdded"
+    constructor(
+        ctx: JsonContext,
+        public node: LionWebJsonNode,
+        public property: LionWebJsonMetaPointer
+    ) {
+        super(ctx)
+    }
+
+    protected msg = () => `Node "${this.node.id}" containment added: "${asMinimalJsonString(this.property)}"`
+}

package/src/changes/ReferenceChange.ts

@@ -0,0 +1,33 @@
+import { LionWebJsonNode, LionWebJsonReference, LionWebJsonReferenceTarget } from "@lionweb/json"
+import { JsonContext } from "@lionweb/json-utils"
+import { Change, Missing } from "./Change.js"
+
+export abstract class ReferenceChange extends Change {
+    constructor(
+        public context: JsonContext,
+        public node: LionWebJsonNode,
+        public beforeReference: LionWebJsonReference | undefined,
+        public afterReference: LionWebJsonReference | undefined,
+        public target: LionWebJsonReferenceTarget,
+        public missing = Missing.NotMissing
+    ) {
+        super(context)
+    }
+}
+
+export class TargetAdded extends ReferenceChange {
+    readonly changeType = "TargetAdded"
+    protected msg = () =>
+        `Node "${this.node.id}" added target "${this.target.reference}" to reference "${this?.afterReference?.reference?.key}"`
+}
+
+export class TargetRemoved extends ReferenceChange {
+    readonly changeType = "TargetRemoved"
+    protected msg = () =>
+        `Node "${this.node.id}" removed target "${this.target.reference}" from reference "${this?.beforeReference?.reference?.key}"`
+}
+
+export class TargetOrderChanged extends ReferenceChange {
+    readonly changeType = "TargetOrderChanged"
+    protected msg = () => `Node "${this.node.id}" changed order of targets in reference "${this.afterReference?.reference?.key}"`
+}

package/src/changes/index.ts

@@ -0,0 +1,6 @@
+export * from "./Change.js"
+export * from "./ChunkChange.js"
+export * from "./ContainmentChange.js"
+export * from "./NodeChange.js"
+export * from "./PropertyChange.js"
+export * from "./ReferenceChange.js"

package/src/index.ts

@@ -0,0 +1,3 @@
+export * from "./changes/index.js"
+export * from "./DiffResult.js"
+export * from "./LionWebJsonDiff.js"