@ddd-ts/event-tree 0.0.0-eventviz.3 → 0.0.0-eventviz.4

package/dist/edge.d.ts

@@ -0,0 +1,39 @@
+type EventRef = {
+    type: "event";
+    name: string;
+};
+type CommandRef = {
+    type: "command";
+    name: string;
+};
+type Reactor = {
+    type: "saga" | "aggregate" | "projection";
+    name: string;
+};
+type Sender = {
+    type: "saga" | "aggregate";
+    name: string;
+};
+type Source = {
+    file: string;
+    start: number;
+};
+export type Edge = {
+    from: EventRef;
+    to: Reactor;
+    source: Source;
+} | {
+    from: Sender;
+    to: CommandRef;
+    source: Source;
+} | {
+    from: Sender;
+    to: EventRef;
+    source: Source;
+} | {
+    from: CommandRef;
+    to: EventRef;
+    source: Source;
+};
+export {};
+//# sourceMappingURL=edge.d.ts.map

package/dist/edge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edge.d.ts","sourceRoot":"","sources":["../src/edge.ts"],"names":[],"mappings":"AAAA,KAAK,QAAQ,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAChD,KAAK,UAAU,GAAG;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AACpD,KAAK,OAAO,GAAG;IAAE,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAC3E,KAAK,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3D,KAAK,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9C,MAAM,MAAM,IAAI,GACZ;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC/C;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/engine/defaults/_example.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=_example.d.ts.map

package/dist/engine/defaults/_example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_example.d.ts","sourceRoot":"","sources":["../../../src/engine/defaults/_example.ts"],"names":[],"mappings":""}

package/dist/engine/defaults/_utils.d.ts

@@ -0,0 +1,14 @@
+import type { Class, Decorator, MethodDefinition, Node } from "oxc-parser";
+export declare function identifierName(node: Node | null | undefined): string | null;
+export declare function memberPath(node: Node | null | undefined): string | null;
+export declare function walkSubtree(node: Node | null | undefined, visit: (n: Node) => void): void;
+export declare function readStringLiteral(node: Node | null | undefined): string | null;
+export declare function superGenericIdentifier(node: Class): string | null;
+export declare function reactorEvents(decorators: Decorator[] | undefined, allowedCallees: Set<string>): string[];
+export declare function methodEffects(method: MethodDefinition): {
+    sends: string[];
+    emits: string[];
+};
+export declare function classMethods(node: Class): MethodDefinition[];
+export declare function methodName(method: MethodDefinition): string | null;
+//# sourceMappingURL=_utils.d.ts.map

package/dist/engine/defaults/_utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_utils.d.ts","sourceRoot":"","sources":["../../../src/engine/defaults/_utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,KAAK,EACL,SAAS,EACT,gBAAgB,EAChB,IAAI,EACL,MAAM,YAAY,CAAC;AAEpB,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAM3E;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAQvE;AAOD,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,IAAI,KAAK,IAAI,QAYlF;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,SAAS,iBAK9D;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,KAAK,iBAKjD;AAED,wBAAgB,aAAa,CAC3B,UAAU,EAAE,SAAS,EAAE,GAAG,SAAS,EACnC,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,YAc5B;AAKD,wBAAgB,aAAa,CAAC,MAAM,EAAE,gBAAgB;;;EAmCrD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,KAAK,sBAQvC;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,gBAAgB,iBAElD"}

package/dist/engine/defaults/_utils.mjs

@@ -0,0 +1,106 @@
+//#region src/engine/defaults/_utils.ts
+function identifierName(node) {
+	if (!node) return null;
+	if (node.type === "Identifier") return node.name;
+	if (node.type === "PrivateIdentifier") return node.name;
+	if (node.type === "MemberExpression") return identifierName(node.property);
+	return null;
+}
+function memberPath(node) {
+	if (!node) return null;
+	if (node.type === "Identifier") return node.name;
+	if (node.type !== "MemberExpression") return null;
+	const left = memberPath(node.object);
+	const right = identifierName(node.property);
+	if (left && right) return `${left}.${right}`;
+	return right ?? left;
+}
+function isNode(value) {
+	if (!value || typeof value !== "object") return false;
+	return typeof value.type === "string";
+}
+function walkSubtree(node, visit) {
+	if (!node) return;
+	visit(node);
+	for (const key of Object.keys(node)) {
+		if (key === "loc" || key === "range" || key === "parent") continue;
+		const child = node[key];
+		if (Array.isArray(child)) {
+			for (const c of child) if (isNode(c)) walkSubtree(c, visit);
+		} else if (isNode(child)) walkSubtree(child, visit);
+	}
+}
+function readStringLiteral(node) {
+	if (!node) return null;
+	if (node.type !== "Literal") return null;
+	if (typeof node.value !== "string") return null;
+	return node.value;
+}
+function superGenericIdentifier(node) {
+	const first = node.superTypeArguments?.params[0];
+	if (!first || first.type !== "TSTypeReference") return null;
+	if (first.typeName.type !== "Identifier") return null;
+	return first.typeName.name;
+}
+function reactorEvents(decorators, allowedCallees) {
+	if (!decorators) return [];
+	const events = [];
+	for (const d of decorators) {
+		if (d.expression.type !== "CallExpression") continue;
+		const callee = memberPath(d.expression.callee);
+		if (!callee || !allowedCallees.has(callee)) continue;
+		const a0 = d.expression.arguments[0];
+		if (a0?.type === "Identifier") events.push(a0.name);
+	}
+	return events;
+}
+const SEND_MEMBERS = new Set([
+	"execute",
+	"dispatch",
+	"send"
+]);
+const EMIT_MEMBERS = new Set(["publish", "emit"]);
+function methodEffects(method) {
+	const sends = /* @__PURE__ */ new Set();
+	const emits = /* @__PURE__ */ new Set();
+	const consumedNew = /* @__PURE__ */ new WeakSet();
+	walkSubtree(method.value.body, (n) => {
+		if (n.type !== "CallExpression") return;
+		const a0 = n.arguments[0];
+		let arg0New = null;
+		if (a0?.type === "NewExpression") arg0New = identifierName(a0.callee);
+		else if (a0?.type === "Identifier") arg0New = a0.name;
+		if (!arg0New) return;
+		if (n.callee.type !== "MemberExpression") return;
+		const member = identifierName(n.callee.property);
+		if (!member) return;
+		if (SEND_MEMBERS.has(member)) {
+			sends.add(arg0New);
+			if (a0?.type === "NewExpression") consumedNew.add(a0);
+		} else if (EMIT_MEMBERS.has(member)) {
+			emits.add(arg0New);
+			if (a0?.type === "NewExpression") consumedNew.add(a0);
+		}
+	});
+	walkSubtree(method.value.body, (n) => {
+		if (n.type !== "NewExpression") return;
+		if (consumedNew.has(n)) return;
+		const id = identifierName(n.callee);
+		if (id) emits.add(id);
+	});
+	return {
+		sends: [...sends],
+		emits: [...emits]
+	};
+}
+function classMethods(node) {
+	const out = [];
+	for (const member of node.body.body) if (member.type === "MethodDefinition" || member.type === "TSAbstractMethodDefinition") out.push(member);
+	return out;
+}
+function methodName(method) {
+	return identifierName(method.key);
+}
+
+//#endregion
+export { classMethods, identifierName, memberPath, methodEffects, methodName, reactorEvents, readStringLiteral, superGenericIdentifier, walkSubtree };

package/dist/engine/defaults/command-handler.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=command-handler.d.ts.map

package/dist/engine/defaults/command-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-handler.d.ts","sourceRoot":"","sources":["../../../src/engine/defaults/command-handler.ts"],"names":[],"mappings":""}

package/dist/engine/defaults/command-handler.mjs

@@ -0,0 +1,36 @@
+import { engine } from "../engine.mjs";
+import { identifierName, superGenericIdentifier, walkSubtree } from "./_utils.mjs";
+
+//#region src/engine/defaults/command-handler.ts
+engine.on((node, parent, ctx, file) => {
+	if (node.type !== "ClassDeclaration") return;
+	if (!node.id) return;
+	const sup = node.superClass;
+	if (sup?.type !== "Identifier" || sup.name !== "CommandHandler") return;
+	const command = superGenericIdentifier(node);
+	if (!command) return;
+	const seen = /* @__PURE__ */ new Set();
+	walkSubtree(node.body, (n) => {
+		if (n.type !== "NewExpression") return;
+		const event = identifierName(n.callee);
+		if (!event || seen.has(event)) return;
+		seen.add(event);
+		engine.saveEdge({
+			from: {
+				type: "command",
+				name: command
+			},
+			to: {
+				type: "event",
+				name: event
+			},
+			source: {
+				file,
+				start: n.start
+			}
+		});
+	});
+});
+
+//#endregion
+export {  };

package/dist/engine/defaults/command.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=command.d.ts.map

package/dist/engine/defaults/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../src/engine/defaults/command.ts"],"names":[],"mappings":""}

package/dist/engine/defaults/command.mjs

@@ -0,0 +1,29 @@
+import { engine } from "../engine.mjs";
+
+//#region src/engine/defaults/command.ts
+const COMMAND_BASES = new Set(["$Command", "Command"]);
+engine.on((node, parent, ctx, file) => {
+	if (node.type !== "ClassDeclaration") return;
+	if (!node.id) return;
+	const sup = node.superClass;
+	if (!sup) return;
+	let base = null;
+	if (sup.type === "Identifier") {
+		if (COMMAND_BASES.has(sup.name)) base = sup.name;
+	} else if (sup.type === "CallExpression") {
+		if (sup.callee?.type === "Identifier" && COMMAND_BASES.has(sup.callee.name)) base = sup.callee.name;
+	}
+	if (!base) return;
+	engine.saveNode({
+		type: "command",
+		name: node.id.name,
+		meta: { base },
+		source: {
+			file,
+			start: node.start
+		}
+	});
+});
+
+//#endregion
+export {  };

package/dist/engine/defaults/es-aggregate.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=es-aggregate.d.ts.map

package/dist/engine/defaults/es-aggregate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"es-aggregate.d.ts","sourceRoot":"","sources":["../../../src/engine/defaults/es-aggregate.ts"],"names":[],"mappings":""}

package/dist/engine/defaults/es-aggregate.mjs

@@ -0,0 +1,82 @@
+import { engine } from "../engine.mjs";
+import { classMethods, methodEffects, methodName, reactorEvents } from "./_utils.mjs";
+
+//#region src/engine/defaults/es-aggregate.ts
+const REACTOR_DECORATORS = new Set([
+	"EsAggregate.on",
+	"on",
+	"On"
+]);
+engine.on((node, parent, ctx, file) => {
+	if (node.type !== "ClassDeclaration") return;
+	if (!node.id) return;
+	const sup = node.superClass;
+	if (!sup) return;
+	if (sup.type === "Identifier") {
+		if (sup.name !== "EsAggregate") return;
+	} else if (sup.type === "CallExpression") {
+		if (sup.callee?.type !== "Identifier" || sup.callee.name !== "EsAggregate") return;
+	} else return;
+	const className = node.id.name;
+	for (const method of classMethods(node)) {
+		const name = methodName(method);
+		if (!name) continue;
+		const events = reactorEvents(method.decorators, REACTOR_DECORATORS);
+		if (!events.length) continue;
+		const handlerName = `${className}.${name}`;
+		engine.saveNode({
+			type: "aggregate",
+			name: handlerName,
+			source: {
+				file,
+				start: method.start
+			}
+		});
+		for (const event of events) engine.saveEdge({
+			from: {
+				type: "event",
+				name: event
+			},
+			to: {
+				type: "aggregate",
+				name: handlerName
+			},
+			source: {
+				file,
+				start: method.start
+			}
+		});
+		const effects = methodEffects(method);
+		for (const command of effects.sends) engine.saveEdge({
+			from: {
+				type: "aggregate",
+				name: handlerName
+			},
+			to: {
+				type: "command",
+				name: command
+			},
+			source: {
+				file,
+				start: method.start
+			}
+		});
+		for (const event of effects.emits) engine.saveEdge({
+			from: {
+				type: "aggregate",
+				name: handlerName
+			},
+			to: {
+				type: "event",
+				name: event
+			},
+			source: {
+				file,
+				start: method.start
+			}
+		});
+	}
+});
+
+//#endregion
+export {  };

package/dist/engine/defaults/event.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=event.d.ts.map

package/dist/engine/defaults/event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.d.ts","sourceRoot":"","sources":["../../../src/engine/defaults/event.ts"],"names":[],"mappings":""}

package/dist/engine/defaults/event.mjs

@@ -0,0 +1,49 @@
+import { engine } from "../engine.mjs";
+import { readStringLiteral } from "./_utils.mjs";
+
+//#region src/engine/defaults/event.ts
+const EVENT_BASES = new Set([
+	"EsEvent",
+	"OldEvent",
+	"Event"
+]);
+engine.on((node, parent, ctx, file) => {
+	if (node.type !== "ClassDeclaration") return;
+	if (!node.id) return;
+	const sup = node.superClass;
+	if (!sup) return;
+	if (sup.type === "Identifier") {
+		if (!EVENT_BASES.has(sup.name)) return;
+		engine.saveNode({
+			type: "event",
+			name: node.id.name,
+			meta: {
+				alias: node.id.name,
+				base: sup.name
+			},
+			source: {
+				file,
+				start: node.start
+			}
+		});
+		return;
+	}
+	if (sup.type !== "CallExpression") return;
+	if (sup.callee?.type !== "Identifier") return;
+	if (!EVENT_BASES.has(sup.callee.name)) return;
+	engine.saveNode({
+		type: "event",
+		name: node.id.name,
+		meta: {
+			alias: readStringLiteral(sup.arguments?.[0]) ?? node.id.name,
+			base: sup.callee.name
+		},
+		source: {
+			file,
+			start: node.start
+		}
+	});
+});
+
+//#endregion
+export {  };

package/dist/engine/defaults/index.d.ts

@@ -0,0 +1,8 @@
+import "./event";
+import "./command";
+import "./saga";
+import "./es-aggregate";
+import "./projection";
+import "./command-handler";
+import "./scanner";
+//# sourceMappingURL=index.d.ts.map

package/dist/engine/defaults/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engine/defaults/index.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,CAAC;AACjB,OAAO,WAAW,CAAC;AACnB,OAAO,QAAQ,CAAC;AAChB,OAAO,gBAAgB,CAAC;AACxB,OAAO,cAAc,CAAC;AACtB,OAAO,mBAAmB,CAAC;AAC3B,OAAO,WAAW,CAAC"}

package/dist/engine/defaults/index.mjs

@@ -0,0 +1,9 @@
+import "./event.mjs";
+import "./command.mjs";
+import "./saga.mjs";
+import "./es-aggregate.mjs";
+import "./projection.mjs";
+import "./command-handler.mjs";
+import "./scanner.mjs";
+
+export {  };

package/dist/engine/defaults/projection.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=projection.d.ts.map

package/dist/engine/defaults/projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection.d.ts","sourceRoot":"","sources":["../../../src/engine/defaults/projection.ts"],"names":[],"mappings":""}

package/dist/engine/defaults/projection.mjs

@@ -0,0 +1,59 @@
+import { engine } from "../engine.mjs";
+import { classMethods, memberPath, methodName, reactorEvents, readStringLiteral } from "./_utils.mjs";
+
+//#region src/engine/defaults/projection.ts
+const REACTOR_DECORATORS = new Set([
+	"Projection.on",
+	"on",
+	"On"
+]);
+const PROJECTION_CALLEES = new Set(["Projection", "Projection.from"]);
+engine.on((node, parent, ctx, file) => {
+	if (node.type !== "ClassDeclaration") return;
+	if (!node.id) return;
+	const sup = node.superClass;
+	if (!sup) return;
+	let alias = null;
+	if (sup.type === "Identifier") {
+		if (sup.name !== "Projection") return;
+	} else if (sup.type === "CallExpression") {
+		const callee = memberPath(sup.callee);
+		if (!callee || !PROJECTION_CALLEES.has(callee)) return;
+		alias = readStringLiteral(sup.arguments?.[0]);
+	} else return;
+	const className = node.id.name;
+	const projectionAlias = alias ?? className;
+	for (const method of classMethods(node)) {
+		const name = methodName(method);
+		if (!name) continue;
+		const events = reactorEvents(method.decorators, REACTOR_DECORATORS);
+		if (!events.length) continue;
+		const handlerName = `${className}.${name}`;
+		engine.saveNode({
+			type: "projection",
+			name: handlerName,
+			meta: { alias: `${projectionAlias}.${name}` },
+			source: {
+				file,
+				start: method.start
+			}
+		});
+		for (const event of events) engine.saveEdge({
+			from: {
+				type: "event",
+				name: event
+			},
+			to: {
+				type: "projection",
+				name: handlerName
+			},
+			source: {
+				file,
+				start: method.start
+			}
+		});
+	}
+});
+
+//#endregion
+export {  };

package/dist/engine/defaults/saga.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=saga.d.ts.map

package/dist/engine/defaults/saga.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"saga.d.ts","sourceRoot":"","sources":["../../../src/engine/defaults/saga.ts"],"names":[],"mappings":""}

package/dist/engine/defaults/saga.mjs

@@ -0,0 +1,77 @@
+import { engine } from "../engine.mjs";
+import { classMethods, methodEffects, methodName, reactorEvents } from "./_utils.mjs";
+
+//#region src/engine/defaults/saga.ts
+const REACTOR_DECORATORS = new Set([
+	"Saga.on",
+	"on",
+	"On"
+]);
+engine.on((node, parent, ctx, file) => {
+	if (node.type !== "ClassDeclaration") return;
+	if (!node.id) return;
+	const sup = node.superClass;
+	if (sup?.type !== "Identifier" || sup.name !== "Saga") return;
+	const className = node.id.name;
+	for (const method of classMethods(node)) {
+		const name = methodName(method);
+		if (!name) continue;
+		const events = reactorEvents(method.decorators, REACTOR_DECORATORS);
+		if (!events.length) continue;
+		const handlerName = `${className}.${name}`;
+		engine.saveNode({
+			type: "saga",
+			name: handlerName,
+			source: {
+				file,
+				start: method.start
+			}
+		});
+		for (const event of events) engine.saveEdge({
+			from: {
+				type: "event",
+				name: event
+			},
+			to: {
+				type: "saga",
+				name: handlerName
+			},
+			source: {
+				file,
+				start: method.start
+			}
+		});
+		const effects = methodEffects(method);
+		for (const command of effects.sends) engine.saveEdge({
+			from: {
+				type: "saga",
+				name: handlerName
+			},
+			to: {
+				type: "command",
+				name: command
+			},
+			source: {
+				file,
+				start: method.start
+			}
+		});
+		for (const event of effects.emits) engine.saveEdge({
+			from: {
+				type: "saga",
+				name: handlerName
+			},
+			to: {
+				type: "event",
+				name: event
+			},
+			source: {
+				file,
+				start: method.start
+			}
+		});
+	}
+});
+
+//#endregion
+export {  };

package/dist/engine/defaults/scanner.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=scanner.d.ts.map

package/dist/engine/defaults/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../../src/engine/defaults/scanner.ts"],"names":[],"mappings":""}

package/dist/engine/defaults/scanner.mjs

@@ -0,0 +1,29 @@
+import { engine } from "../engine.mjs";
+import fs from "node:fs";
+import { join } from "node:path";
+
+//#region src/engine/defaults/scanner.ts
+engine.scan(function* (root = process.cwd()) {
+	yield* fs.globSync("**/*.ts", {
+		cwd: root,
+		exclude: [
+			"**/node_modules/**",
+			"**/dist/**",
+			"**/build/**",
+			"**/.git/**",
+			"**/.turbo/**",
+			"**/coverage/**",
+			"**/.next/**",
+			"**/.cache/**",
+			"**/.vite/**",
+			"**/*.d.ts",
+			"**/*.spec.ts",
+			"**/*.test.ts",
+			"**/*.typecheck.spec.ts"
+		],
+		withFileTypes: false
+	}).map((p) => join(root, p));
+});
+
+//#endregion
+export {  };

package/dist/engine/engine.d.ts

@@ -0,0 +1,21 @@
+import { type WalkerEnter } from "oxc-walker";
+import type { Node } from "../node";
+import type { Edge } from "../edge";
+type AstWalker = (...args: [...Parameters<WalkerEnter>, file: string]) => ReturnType<WalkerEnter>;
+export declare class Engine {
+    private astWalkers;
+    on(walker: AstWalker): this;
+    private fileScanner;
+    scan(fileScanner: (root: string) => Iterable<string>): this;
+    private edges;
+    saveEdge(edge: Edge): void;
+    getEdges(): readonly Edge[];
+    private nodes;
+    saveNode(node: Node): void;
+    getNodes(): readonly Node[];
+    reset(): void;
+    run(root?: string): void;
+}
+export declare const engine: Engine;
+export {};
+//# sourceMappingURL=engine.d.ts.map

package/dist/engine/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/engine/engine.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAEpC,KAAK,SAAS,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,UAAU,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,UAAU,CAAC,WAAW,CAAC,CAAA;AAEjG,qBAAa,MAAM;IACjB,OAAO,CAAC,UAAU,CAAkB;IAEpC,EAAE,CAAC,MAAM,EAAE,SAAS;IAKpB,OAAO,CAAC,WAAW,CAEjB;IACF,IAAI,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,QAAQ,CAAC,MAAM,CAAC;IAKpD,OAAO,CAAC,KAAK,CAAc;IAC3B,QAAQ,CAAC,IAAI,EAAE,IAAI;IAGnB,QAAQ,IAAI,SAAS,IAAI,EAAE;IAI3B,OAAO,CAAC,KAAK,CAAc;IAC3B,QAAQ,CAAC,IAAI,EAAE,IAAI;IAGnB,QAAQ,IAAI,SAAS,IAAI,EAAE;IAI3B,KAAK;IAKL,GAAG,CAAC,IAAI,GAAE,MAAsB;CAiBjC;AAED,eAAO,MAAM,MAAM,QAAe,CAAC"}

package/dist/engine/engine.mjs

@@ -0,0 +1,54 @@
+import fs from "node:fs";
+import { parseAndWalk } from "oxc-walker";
+
+//#region src/engine/engine.ts
+var Engine = class {
+	astWalkers = [];
+	on(walker) {
+		this.astWalkers.push(walker);
+		return this;
+	}
+	fileScanner = function* () {
+		console.warn(`No file scanner configured for event-tree engine. Please call engine.scan() with a file scanner function.`);
+	};
+	scan(fileScanner) {
+		this.fileScanner = fileScanner;
+		return this;
+	}
+	edges = [];
+	saveEdge(edge) {
+		this.edges.push(edge);
+	}
+	getEdges() {
+		return this.edges;
+	}
+	nodes = [];
+	saveNode(node) {
+		this.nodes.push(node);
+	}
+	getNodes() {
+		return this.nodes;
+	}
+	reset() {
+		this.edges = [];
+		this.nodes = [];
+	}
+	run(root = process.cwd()) {
+		for (const file of this.fileScanner(root)) {
+			const code = fs.readFileSync(file, "utf8");
+			const walkers = this.astWalkers;
+			parseAndWalk(code, file, { enter: function(node, parent, ctx) {
+				for (const walker of walkers) try {
+					walker.call(this, node, parent, ctx, file);
+				} catch (error) {
+					console.error(`Error occurred while walking node in file ${file}:`, error);
+				}
+			} });
+		}
+	}
+};
+const engine = new Engine();
+await import("./defaults/index.mjs");
+
+//#endregion
+export { Engine, engine };

package/dist/index.mjs

@@ -0,0 +1,3 @@
+import { Engine, engine } from "./engine/engine.mjs";
+
+export { Engine, engine };

package/dist/node.d.ts

@@ -0,0 +1,37 @@
+type Source = {
+    file: string;
+    start: number;
+};
+export type Node = {
+    type: "event";
+    name: string;
+    meta: {
+        alias: string;
+        base: string;
+    };
+    source: Source;
+} | {
+    type: "command";
+    name: string;
+    meta: {
+        base: string;
+    };
+    source: Source;
+} | {
+    type: "saga";
+    name: string;
+    source: Source;
+} | {
+    type: "aggregate";
+    name: string;
+    source: Source;
+} | {
+    type: "projection";
+    name: string;
+    meta: {
+        alias: string;
+    };
+    source: Source;
+};
+export {};
+//# sourceMappingURL=node.d.ts.map

package/dist/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA,KAAK,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9C,MAAM,MAAM,IAAI,GACZ;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACtF;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACzE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/server/index.d.ts

@@ -0,0 +1,4 @@
+export { engine, Engine } from "../engine/engine";
+export type { Node } from "../node";
+export type { Edge } from "../edge";
+//# sourceMappingURL=index.d.ts.map

package/dist/server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AACpC,YAAY,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ddd-ts/event-tree",
-  "version": "0.0.0-eventviz.3",
+  "version": "0.0.0-eventviz.4",
   "types": "dist/server/index.d.ts",
   "license": "MIT",
   "repository": {
@@ -14,7 +14,7 @@
     "oxc-walker": "^1.0.0"
   },
   "devDependencies": {
-    "@ddd-ts/tools": "0.0.0-eventviz.3",
+    "@ddd-ts/tools": "0.0.0-eventviz.4",
     "@types/node": "^22.14.1"
   },
   "exports": {