@terra-graph/core 1.0.0-rc.4

package/dist/cjs/Graph/Rules/Edge/EdgeSemanticLegend.test.js

@@ -0,0 +1,511 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const graphology_1 = require("graphology");
+const GraphologyAdapter_js_1 = require("../../Adapters/GraphologyAdapter.js");
+const TgGraph_js_1 = require("../../TgGraph.js");
+const EdgeSemanticLegend_js_1 = require("./EdgeSemanticLegend.js");
+describe('EdgeSemanticLegend.constructor', () => {
+    it('shoud require options', () => {
+        expect(() => new EdgeSemanticLegend_js_1.EdgeSemanticLegend({
+            edge: { from: { any: true }, to: { any: true } },
+        })).toThrow(`Rule 'EdgeSemanticLegend' requires options in config`);
+    });
+    it('shoud require legendBySemantic to be an object', () => {
+        expect(() => new EdgeSemanticLegend_js_1.EdgeSemanticLegend({
+            edge: { from: { any: true }, to: { any: true } },
+            options: {
+                legendBySemantic: null,
+            },
+        })).toThrow(`Rule 'EdgeSemanticLegend' requires options.legendBySemantic`);
+    });
+    it('shoud reject invalid semantic keys', () => {
+        expect(() => new EdgeSemanticLegend_js_1.EdgeSemanticLegend({
+            edge: { from: { any: true }, to: { any: true } },
+            options: {
+                legendBySemantic: {
+                    invalid: { title: 'Invalid', colour: '#000000' },
+                },
+            },
+        })).toThrow(`Rule 'EdgeSemanticLegend' has an invalid semantic key 'invalid'`);
+    });
+    it('shoud require title and colour for each semantic entry', () => {
+        expect(() => new EdgeSemanticLegend_js_1.EdgeSemanticLegend({
+            edge: { from: { any: true }, to: { any: true } },
+            options: {
+                legendBySemantic: {
+                    [TgGraph_js_1.TgEdgeDirectionSemantics.Invokes]: { title: 'Invokes' },
+                },
+            },
+        })).toThrow(`Rule 'EdgeSemanticLegend' requires title and colour for semantic 'invokes'`);
+    });
+    it('shoud require overwrite to be a boolean when provided', () => {
+        expect(() => new EdgeSemanticLegend_js_1.EdgeSemanticLegend({
+            edge: { from: { any: true }, to: { any: true } },
+            options: {
+                legendBySemantic: {
+                    [TgGraph_js_1.TgEdgeDirectionSemantics.Invokes]: {
+                        title: 'Invokes',
+                        colour: '#1f77b4',
+                    },
+                },
+                overwrite: 'yes',
+            },
+        })).toThrow(`Rule 'EdgeSemanticLegend' options.overwrite must be a boolean when provided`);
+    });
+});
+describe('EdgeSemanticLegend.apply', () => {
+    it('shoud set legend values for mapped edge semantics', () => {
+        const nodeA = (0, TgGraph_js_1.asNodeId)('node-a');
+        const nodeB = (0, TgGraph_js_1.asNodeId)('node-b');
+        const nodeC = (0, TgGraph_js_1.asNodeId)('node-c');
+        const invokesEdgeId = (0, TgGraph_js_1.asEdgeId)('edge-a-b');
+        const accessesEdgeId = (0, TgGraph_js_1.asEdgeId)('edge-a-c');
+        const tg = {
+            schemaVersion: TgGraph_js_1.TG_SCHEMA_VERSION,
+            description: {},
+            nodes: {
+                [nodeA]: { id: nodeA, label: 'A' },
+                [nodeB]: { id: nodeB, label: 'B' },
+                [nodeC]: { id: nodeC, label: 'C' },
+            },
+            edges: [
+                {
+                    id: invokesEdgeId,
+                    from: nodeA,
+                    to: nodeB,
+                    attributes: {
+                        directionSemantic: TgGraph_js_1.TgEdgeDirectionSemantics.Invokes,
+                    },
+                },
+                {
+                    id: accessesEdgeId,
+                    from: nodeA,
+                    to: nodeC,
+                    attributes: {
+                        directionSemantic: TgGraph_js_1.TgEdgeDirectionSemantics.Accesses,
+                    },
+                },
+            ],
+        };
+        const adapter = new GraphologyAdapter_js_1.GraphologyAdapter(new graphology_1.DirectedGraph()).withTgGraph(tg);
+        const node = adapter.getNodeAttributes(nodeA);
+        if (!node) {
+            throw new Error('Missing node attributes for node-a');
+        }
+        const rule = new EdgeSemanticLegend_js_1.EdgeSemanticLegend({
+            edge: {
+                from: { any: true },
+                to: { any: true },
+            },
+            options: {
+                legendBySemantic: {
+                    [TgGraph_js_1.TgEdgeDirectionSemantics.Invokes]: {
+                        title: 'Invokes',
+                        colour: '#1f77b4',
+                    },
+                },
+            },
+        });
+        rule.match(nodeA, node, adapter);
+        const result = rule.apply(nodeA, node, adapter);
+        expect(result.getEdgeAttributes(invokesEdgeId)).toEqual({
+            directionSemantic: TgGraph_js_1.TgEdgeDirectionSemantics.Invokes,
+            legend: {
+                title: 'Invokes',
+                colour: '#1f77b4',
+            },
+        });
+        expect(result.getEdgeAttributes(accessesEdgeId)).toEqual({
+            directionSemantic: TgGraph_js_1.TgEdgeDirectionSemantics.Accesses,
+        });
+    });
+    it('shoud keep existing legend when overwrite is false', () => {
+        const nodeA = (0, TgGraph_js_1.asNodeId)('node-a');
+        const nodeB = (0, TgGraph_js_1.asNodeId)('node-b');
+        const edgeId = (0, TgGraph_js_1.asEdgeId)('edge-a-b');
+        const tg = {
+            schemaVersion: TgGraph_js_1.TG_SCHEMA_VERSION,
+            description: {},
+            nodes: {
+                [nodeA]: { id: nodeA, label: 'A' },
+                [nodeB]: { id: nodeB, label: 'B' },
+            },
+            edges: [
+                {
+                    id: edgeId,
+                    from: nodeA,
+                    to: nodeB,
+                    attributes: {
+                        directionSemantic: TgGraph_js_1.TgEdgeDirectionSemantics.Invokes,
+                        legend: {
+                            title: 'Existing',
+                            colour: '#999999',
+                        },
+                    },
+                },
+            ],
+        };
+        const adapter = new GraphologyAdapter_js_1.GraphologyAdapter(new graphology_1.DirectedGraph()).withTgGraph(tg);
+        const node = adapter.getNodeAttributes(nodeA);
+        if (!node) {
+            throw new Error('Missing node attributes for node-a');
+        }
+        const rule = new EdgeSemanticLegend_js_1.EdgeSemanticLegend({
+            edge: {
+                from: { any: true },
+                to: { any: true },
+            },
+            options: {
+                legendBySemantic: {
+                    [TgGraph_js_1.TgEdgeDirectionSemantics.Invokes]: {
+                        title: 'Invokes',
+                        colour: '#1f77b4',
+                    },
+                },
+            },
+        });
+        rule.match(nodeA, node, adapter);
+        const result = rule.apply(nodeA, node, adapter);
+        expect(result.getEdgeAttributes(edgeId)).toEqual({
+            directionSemantic: TgGraph_js_1.TgEdgeDirectionSemantics.Invokes,
+            legend: {
+                title: 'Existing',
+                colour: '#999999',
+            },
+        });
+    });
+    it('shoud overwrite existing legend when configured', () => {
+        const nodeA = (0, TgGraph_js_1.asNodeId)('node-a');
+        const nodeB = (0, TgGraph_js_1.asNodeId)('node-b');
+        const edgeId = (0, TgGraph_js_1.asEdgeId)('edge-a-b');
+        const tg = {
+            schemaVersion: TgGraph_js_1.TG_SCHEMA_VERSION,
+            description: {},
+            nodes: {
+                [nodeA]: { id: nodeA, label: 'A' },
+                [nodeB]: { id: nodeB, label: 'B' },
+            },
+            edges: [
+                {
+                    id: edgeId,
+                    from: nodeA,
+                    to: nodeB,
+                    attributes: {
+                        directionSemantic: TgGraph_js_1.TgEdgeDirectionSemantics.Invokes,
+                        legend: {
+                            title: 'Existing',
+                            colour: '#999999',
+                        },
+                    },
+                },
+            ],
+        };
+        const adapter = new GraphologyAdapter_js_1.GraphologyAdapter(new graphology_1.DirectedGraph()).withTgGraph(tg);
+        const node = adapter.getNodeAttributes(nodeA);
+        if (!node) {
+            throw new Error('Missing node attributes for node-a');
+        }
+        const rule = new EdgeSemanticLegend_js_1.EdgeSemanticLegend({
+            edge: {
+                from: { any: true },
+                to: { any: true },
+            },
+            options: {
+                legendBySemantic: {
+                    [TgGraph_js_1.TgEdgeDirectionSemantics.Invokes]: {
+                        title: 'Invokes',
+                        colour: '#1f77b4',
+                    },
+                },
+                overwrite: true,
+            },
+        });
+        rule.match(nodeA, node, adapter);
+        const result = rule.apply(nodeA, node, adapter);
+        expect(result.getEdgeAttributes(edgeId)).toEqual({
+            directionSemantic: TgGraph_js_1.TgEdgeDirectionSemantics.Invokes,
+            legend: {
+                title: 'Invokes',
+                colour: '#1f77b4',
+            },
+        });
+    });
+    it('shoud ignore edges without a direction semantic', () => {
+        const nodeA = (0, TgGraph_js_1.asNodeId)('node-a');
+        const nodeB = (0, TgGraph_js_1.asNodeId)('node-b');
+        const edgeId = (0, TgGraph_js_1.asEdgeId)('edge-a-b');
+        const tg = {
+            schemaVersion: TgGraph_js_1.TG_SCHEMA_VERSION,
+            description: {},
+            nodes: {
+                [nodeA]: { id: nodeA, label: 'A' },
+                [nodeB]: { id: nodeB, label: 'B' },
+            },
+            edges: [
+                {
+                    id: edgeId,
+                    from: nodeA,
+                    to: nodeB,
+                    attributes: { weight: 1 },
+                },
+            ],
+        };
+        const adapter = new GraphologyAdapter_js_1.GraphologyAdapter(new graphology_1.DirectedGraph()).withTgGraph(tg);
+        const node = adapter.getNodeAttributes(nodeA);
+        if (!node) {
+            throw new Error('Missing node attributes for node-a');
+        }
+        const rule = new EdgeSemanticLegend_js_1.EdgeSemanticLegend({
+            edge: {
+                from: { any: true },
+                to: { any: true },
+            },
+            options: {
+                legendBySemantic: {
+                    [TgGraph_js_1.TgEdgeDirectionSemantics.Invokes]: {
+                        title: 'Invokes',
+                        colour: '#1f77b4',
+                    },
+                },
+            },
+        });
+        rule.match(nodeA, node, adapter);
+        const result = rule.apply(nodeA, node, adapter);
+        expect(result.getEdgeAttributes(edgeId)).toEqual({ weight: 1 });
+    });
+    it('shoud ignore edges with invalid direction semantics', () => {
+        const nodeA = (0, TgGraph_js_1.asNodeId)('node-a');
+        const nodeB = (0, TgGraph_js_1.asNodeId)('node-b');
+        const edgeId = (0, TgGraph_js_1.asEdgeId)('edge-a-b');
+        const tg = {
+            schemaVersion: TgGraph_js_1.TG_SCHEMA_VERSION,
+            description: {},
+            nodes: {
+                [nodeA]: { id: nodeA, label: 'A' },
+                [nodeB]: { id: nodeB, label: 'B' },
+            },
+            edges: [
+                {
+                    id: edgeId,
+                    from: nodeA,
+                    to: nodeB,
+                    attributes: {
+                        directionSemantic: 'invalid',
+                    },
+                },
+            ],
+        };
+        const adapter = new GraphologyAdapter_js_1.GraphologyAdapter(new graphology_1.DirectedGraph()).withTgGraph(tg);
+        const node = adapter.getNodeAttributes(nodeA);
+        if (!node) {
+            throw new Error('Missing node attributes for node-a');
+        }
+        const rule = new EdgeSemanticLegend_js_1.EdgeSemanticLegend({
+            edge: {
+                from: { any: true },
+                to: { any: true },
+            },
+            options: {
+                legendBySemantic: {
+                    [TgGraph_js_1.TgEdgeDirectionSemantics.Invokes]: {
+                        title: 'Invokes',
+                        colour: '#1f77b4',
+                    },
+                },
+            },
+        });
+        rule.match(nodeA, node, adapter);
+        const result = rule.apply(nodeA, node, adapter);
+        expect(result.getEdgeAttributes(edgeId)).toEqual({
+            directionSemantic: 'invalid',
+        });
+    });
+    it('shoud ignore edges when no legend is mapped for the semantic', () => {
+        const nodeA = (0, TgGraph_js_1.asNodeId)('node-a');
+        const nodeB = (0, TgGraph_js_1.asNodeId)('node-b');
+        const edgeId = (0, TgGraph_js_1.asEdgeId)('edge-a-b');
+        const tg = {
+            schemaVersion: TgGraph_js_1.TG_SCHEMA_VERSION,
+            description: {},
+            nodes: {
+                [nodeA]: { id: nodeA, label: 'A' },
+                [nodeB]: { id: nodeB, label: 'B' },
+            },
+            edges: [
+                {
+                    id: edgeId,
+                    from: nodeA,
+                    to: nodeB,
+                    attributes: {
+                        directionSemantic: TgGraph_js_1.TgEdgeDirectionSemantics.Accesses,
+                    },
+                },
+            ],
+        };
+        const adapter = new GraphologyAdapter_js_1.GraphologyAdapter(new graphology_1.DirectedGraph()).withTgGraph(tg);
+        const node = adapter.getNodeAttributes(nodeA);
+        if (!node) {
+            throw new Error('Missing node attributes for node-a');
+        }
+        const rule = new EdgeSemanticLegend_js_1.EdgeSemanticLegend({
+            edge: {
+                from: { any: true },
+                to: { any: true },
+            },
+            options: {
+                legendBySemantic: {
+                    [TgGraph_js_1.TgEdgeDirectionSemantics.Invokes]: {
+                        title: 'Invokes',
+                        colour: '#1f77b4',
+                    },
+                },
+            },
+        });
+        rule.match(nodeA, node, adapter);
+        const result = rule.apply(nodeA, node, adapter);
+        expect(result.getEdgeAttributes(edgeId)).toEqual({
+            directionSemantic: TgGraph_js_1.TgEdgeDirectionSemantics.Accesses,
+        });
+    });
+    it('shoud keep graph unchanged when apply is called without a match', () => {
+        const nodeA = (0, TgGraph_js_1.asNodeId)('node-a');
+        const nodeB = (0, TgGraph_js_1.asNodeId)('node-b');
+        const edgeId = (0, TgGraph_js_1.asEdgeId)('edge-a-b');
+        const tg = {
+            schemaVersion: TgGraph_js_1.TG_SCHEMA_VERSION,
+            description: {},
+            nodes: {
+                [nodeA]: { id: nodeA, label: 'A' },
+                [nodeB]: { id: nodeB, label: 'B' },
+            },
+            edges: [
+                {
+                    id: edgeId,
+                    from: nodeA,
+                    to: nodeB,
+                    attributes: {
+                        directionSemantic: TgGraph_js_1.TgEdgeDirectionSemantics.Invokes,
+                    },
+                },
+            ],
+        };
+        const adapter = new GraphologyAdapter_js_1.GraphologyAdapter(new graphology_1.DirectedGraph()).withTgGraph(tg);
+        const node = adapter.getNodeAttributes(nodeA);
+        if (!node) {
+            throw new Error('Missing node attributes for node-a');
+        }
+        const rule = new EdgeSemanticLegend_js_1.EdgeSemanticLegend({
+            edge: {
+                from: { any: true },
+                to: { any: true },
+            },
+            options: {
+                legendBySemantic: {
+                    [TgGraph_js_1.TgEdgeDirectionSemantics.Invokes]: {
+                        title: 'Invokes',
+                        colour: '#1f77b4',
+                    },
+                },
+            },
+        });
+        const result = rule.apply(nodeA, node, adapter);
+        expect(result.getEdgeAttributes(edgeId)).toEqual({
+            directionSemantic: TgGraph_js_1.TgEdgeDirectionSemantics.Invokes,
+        });
+    });
+    it('shoud return early when the source node no longer matches', () => {
+        const nodeA = (0, TgGraph_js_1.asNodeId)('node-a');
+        const nodeB = (0, TgGraph_js_1.asNodeId)('node-b');
+        const edgeId = (0, TgGraph_js_1.asEdgeId)('edge-a-b');
+        const tg = {
+            schemaVersion: TgGraph_js_1.TG_SCHEMA_VERSION,
+            description: {},
+            nodes: {
+                [nodeA]: { id: nodeA, label: 'A' },
+                [nodeB]: { id: nodeB, label: 'B' },
+            },
+            edges: [
+                {
+                    id: edgeId,
+                    from: nodeA,
+                    to: nodeB,
+                    attributes: {
+                        directionSemantic: TgGraph_js_1.TgEdgeDirectionSemantics.Invokes,
+                    },
+                },
+            ],
+        };
+        const adapter = new GraphologyAdapter_js_1.GraphologyAdapter(new graphology_1.DirectedGraph()).withTgGraph(tg);
+        const node = adapter.getNodeAttributes(nodeA);
+        if (!node) {
+            throw new Error('Missing node attributes for node-a');
+        }
+        const rule = new EdgeSemanticLegend_js_1.EdgeSemanticLegend({
+            edge: {
+                from: { attr: { key: 'label', eq: 'A' } },
+                to: { any: true },
+            },
+            options: {
+                legendBySemantic: {
+                    [TgGraph_js_1.TgEdgeDirectionSemantics.Invokes]: {
+                        title: 'Invokes',
+                        colour: '#1f77b4',
+                    },
+                },
+            },
+        });
+        rule.match(nodeA, node, adapter);
+        const mismatchedNode = { ...node, label: 'mismatch' };
+        const result = rule.apply(nodeA, mismatchedNode, adapter);
+        expect(result.getEdgeAttributes(edgeId)).toEqual({
+            directionSemantic: TgGraph_js_1.TgEdgeDirectionSemantics.Invokes,
+        });
+    });
+    it('shoud skip targets that do not match the query', () => {
+        const nodeA = (0, TgGraph_js_1.asNodeId)('node-a');
+        const nodeB = (0, TgGraph_js_1.asNodeId)('node-b');
+        const edgeId = (0, TgGraph_js_1.asEdgeId)('edge-a-b');
+        const tg = {
+            schemaVersion: TgGraph_js_1.TG_SCHEMA_VERSION,
+            description: {},
+            nodes: {
+                [nodeA]: { id: nodeA, label: 'A' },
+                [nodeB]: { id: nodeB, label: 'B' },
+            },
+            edges: [
+                {
+                    id: edgeId,
+                    from: nodeA,
+                    to: nodeB,
+                    attributes: {
+                        directionSemantic: TgGraph_js_1.TgEdgeDirectionSemantics.Invokes,
+                    },
+                },
+            ],
+        };
+        const adapter = new GraphologyAdapter_js_1.GraphologyAdapter(new graphology_1.DirectedGraph()).withTgGraph(tg);
+        const node = adapter.getNodeAttributes(nodeA);
+        if (!node) {
+            throw new Error('Missing node attributes for node-a');
+        }
+        const rule = new EdgeSemanticLegend_js_1.EdgeSemanticLegend({
+            edge: {
+                from: { nodeId: { eq: 'node-a' } },
+                to: { nodeId: { eq: 'node-c' } },
+            },
+            options: {
+                legendBySemantic: {
+                    [TgGraph_js_1.TgEdgeDirectionSemantics.Invokes]: {
+                        title: 'Invokes',
+                        colour: '#1f77b4',
+                    },
+                },
+            },
+        });
+        rule.match(nodeA, node, adapter);
+        const result = rule.apply(nodeA, node, adapter);
+        expect(result.getEdgeAttributes(edgeId)).toEqual({
+            directionSemantic: TgGraph_js_1.TgEdgeDirectionSemantics.Invokes,
+        });
+    });
+});

package/dist/cjs/Graph/Rules/Edge/ExplicitEdge.d.ts

@@ -0,0 +1,6 @@
+import { AdapterOperations } from '../../Operations/Operations.js';
+import { NodeId, TgNodeAttributes } from '../../TgGraph.js';
+import { EdgeRule } from '../Rule.js';
+export declare class ExplicitEdge extends EdgeRule {
+    apply(nodeId: NodeId, node: TgNodeAttributes, graph: AdapterOperations): AdapterOperations;
+}

package/dist/cjs/Graph/Rules/Edge/ExplicitEdge.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExplicitEdge = void 0;
+const TgGraph_js_1 = require("../../TgGraph.js");
+const Rule_js_1 = require("../Rule.js");
+class ExplicitEdge extends Rule_js_1.EdgeRule {
+    apply(nodeId, node, graph) {
+        if (!this.wasMatched(nodeId)) {
+            return graph;
+        }
+        let updated = graph;
+        const { from, to } = this.query;
+        if (!from.match(nodeId, node, updated)) {
+            return updated;
+        }
+        for (const targetId of updated.nodeIds()) {
+            const target = updated.getNodeAttributes(targetId);
+            if (!target || !to.match(targetId, target, updated)) {
+                continue;
+            }
+            const edgeId = (0, TgGraph_js_1.edgeIdFrom)(nodeId, targetId);
+            updated = updated.setEdge(edgeId, nodeId, targetId, {});
+        }
+        return updated;
+    }
+}
+exports.ExplicitEdge = ExplicitEdge;
+Rule_js_1.EdgeRule.register(ExplicitEdge);

package/dist/cjs/Graph/Rules/Edge/ExplicitEdge.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cjs/Graph/Rules/Edge/ExplicitEdge.test.js

@@ -0,0 +1,125 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const graphology_1 = require("graphology");
+const GraphologyAdapter_js_1 = require("../../Adapters/GraphologyAdapter.js");
+const TgGraph_js_1 = require("../../TgGraph.js");
+const ExplicitEdge_js_1 = require("./ExplicitEdge.js");
+describe('ExplicitEdge.apply', () => {
+    it('shoud add edges from matching source nodes to matching target nodes', () => {
+        const nodeA = (0, TgGraph_js_1.asNodeId)('node-a');
+        const nodeB = (0, TgGraph_js_1.asNodeId)('node-b');
+        const nodeC = (0, TgGraph_js_1.asNodeId)('node-c');
+        const tg = {
+            schemaVersion: TgGraph_js_1.TG_SCHEMA_VERSION,
+            description: {},
+            nodes: {
+                [nodeA]: { id: nodeA, label: 'A' },
+                [nodeB]: { id: nodeB, label: 'B' },
+                [nodeC]: { id: nodeC, label: 'C' },
+            },
+            edges: [],
+        };
+        const hook = new ExplicitEdge_js_1.ExplicitEdge({
+            edge: {
+                from: { nodeId: { eq: 'node-a' } },
+                to: { nodeId: { in: ['node-b', 'node-c'] } },
+            },
+        });
+        const adapter = new GraphologyAdapter_js_1.GraphologyAdapter(new graphology_1.DirectedGraph()).withTgGraph(tg);
+        const node = adapter.getNodeAttributes(nodeA);
+        if (!node) {
+            throw new Error('Missing node attributes for node-a');
+        }
+        hook.match(nodeA, node, adapter);
+        const result = hook.apply(nodeA, node, adapter);
+        const edgeAB = (0, TgGraph_js_1.edgeIdFrom)(nodeA, nodeB);
+        const edgeAC = (0, TgGraph_js_1.edgeIdFrom)(nodeA, nodeC);
+        expect(result.edgeSource(edgeAB)).toBe(nodeA);
+        expect(result.edgeTarget(edgeAB)).toBe(nodeB);
+        expect(result.edgeSource(edgeAC)).toBe(nodeA);
+        expect(result.edgeTarget(edgeAC)).toBe(nodeC);
+        expect(result.getEdgeAttributes(edgeAB)).toEqual({});
+    });
+    it('shoud keep graph unchanged when the hook does not match', () => {
+        const nodeA = (0, TgGraph_js_1.asNodeId)('node-a');
+        const nodeB = (0, TgGraph_js_1.asNodeId)('node-b');
+        const tg = {
+            schemaVersion: TgGraph_js_1.TG_SCHEMA_VERSION,
+            description: {},
+            nodes: {
+                [nodeA]: { id: nodeA, label: 'A' },
+                [nodeB]: { id: nodeB, label: 'B' },
+            },
+            edges: [],
+        };
+        const hook = new ExplicitEdge_js_1.ExplicitEdge({
+            edge: {
+                from: { nodeId: { eq: 'node-a' } },
+                to: { nodeId: { eq: 'node-b' } },
+            },
+        });
+        const adapter = new GraphologyAdapter_js_1.GraphologyAdapter(new graphology_1.DirectedGraph()).withTgGraph(tg);
+        const node = adapter.getNodeAttributes(nodeB);
+        if (!node) {
+            throw new Error('Missing node attributes for node-b');
+        }
+        hook.match(nodeB, node, adapter);
+        const result = hook.apply(nodeB, node, adapter);
+        expect(result.outEdges(nodeA)).toEqual([]);
+    });
+    it('shoud skip targets that do not match the query', () => {
+        const nodeA = (0, TgGraph_js_1.asNodeId)('node-a');
+        const nodeB = (0, TgGraph_js_1.asNodeId)('node-b');
+        const tg = {
+            schemaVersion: TgGraph_js_1.TG_SCHEMA_VERSION,
+            description: {},
+            nodes: {
+                [nodeA]: { id: nodeA, label: 'A' },
+                [nodeB]: { id: nodeB, label: 'B' },
+            },
+            edges: [],
+        };
+        const hook = new ExplicitEdge_js_1.ExplicitEdge({
+            edge: {
+                from: { nodeId: { eq: 'node-a' } },
+                to: { nodeId: { eq: 'node-c' } },
+            },
+        });
+        const adapter = new GraphologyAdapter_js_1.GraphologyAdapter(new graphology_1.DirectedGraph()).withTgGraph(tg);
+        const node = adapter.getNodeAttributes(nodeA);
+        if (!node) {
+            throw new Error('Missing node attributes for node-a');
+        }
+        hook.match(nodeA, node, adapter);
+        const result = hook.apply(nodeA, node, adapter);
+        expect(result.outEdges(nodeA)).toEqual([]);
+    });
+    it('shoud return early when the source node no longer matches', () => {
+        const nodeA = (0, TgGraph_js_1.asNodeId)('node-a');
+        const nodeB = (0, TgGraph_js_1.asNodeId)('node-b');
+        const tg = {
+            schemaVersion: TgGraph_js_1.TG_SCHEMA_VERSION,
+            description: {},
+            nodes: {
+                [nodeA]: { id: nodeA, label: 'A' },
+                [nodeB]: { id: nodeB, label: 'B' },
+            },
+            edges: [],
+        };
+        const hook = new ExplicitEdge_js_1.ExplicitEdge({
+            edge: {
+                from: { attr: { key: 'label', eq: 'A' } },
+                to: { any: true },
+            },
+        });
+        const adapter = new GraphologyAdapter_js_1.GraphologyAdapter(new graphology_1.DirectedGraph()).withTgGraph(tg);
+        const node = adapter.getNodeAttributes(nodeA);
+        if (!node) {
+            throw new Error('Missing node attributes for node-a');
+        }
+        hook.match(nodeA, node, adapter);
+        const mismatchedNode = { ...node, label: 'mismatch' };
+        const result = hook.apply(nodeA, mismatchedNode, adapter);
+        expect(result.outEdges(nodeA)).toEqual([]);
+    });
+});

package/dist/cjs/Graph/Rules/Edge/RemoveEdge.d.ts

@@ -0,0 +1,6 @@
+import { AdapterOperations } from '../../Operations/Operations.js';
+import { NodeId, TgNodeAttributes } from '../../TgGraph.js';
+import { EdgeRule } from '../Rule.js';
+export declare class RemoveEdge extends EdgeRule {
+    apply(nodeId: NodeId, node: TgNodeAttributes, graph: AdapterOperations): AdapterOperations;
+}