@ucdjs/pipelines-graph 0.0.1-beta.7 → 0.0.1-beta.8

package/README.md

@@ -2,7 +2,6 @@
 
 [![npm version][npm-version-src]][npm-version-href]
 [![npm downloads][npm-downloads-src]][npm-downloads-href]
-[![codecov][codecov-src]][codecov-href]
 
 > [!IMPORTANT]
 > This is an internal package. It may change without warning and is not subject to semantic versioning. Use at your own risk.
@@ -15,6 +14,29 @@ A collection of core pipeline functionalities for the UCD project.
 npm install @ucdjs/pipelines-graph
 ```
 
+## Usage
+
+This package keeps graph construction and graph inspection separate from pipeline definition loading and execution.
+Use it when you already have a pipeline definition or execution graph and need a stable graph-shaped view for tooling, visualization, or debugging.
+
+```ts
+import { buildDAG } from "@ucdjs/pipelines-core";
+import { buildRouteGraph, toVisualTree } from "@ucdjs/pipelines-graph";
+
+const dag = buildDAG(pipeline.routes);
+const graph = buildRouteGraph(pipeline, dag);
+
+console.log(toVisualTree(graph));
+```
+
+Example output:
+
+```txt
+└─ route:static:emoji
+   ├─ route:static:groups
+   └─ route:static:summary
+```
+
 ## 📄 License
 
 Published under [MIT License](./LICENSE).
@@ -23,5 +45,3 @@ Published under [MIT License](./LICENSE).
 [npm-version-href]: https://npmjs.com/package/@ucdjs/pipelines-graph
 [npm-downloads-src]: https://img.shields.io/npm/dm/@ucdjs/pipelines-graph?style=flat&colorA=18181B&colorB=4169E1
 [npm-downloads-href]: https://npmjs.com/package/@ucdjs/pipelines-graph
-[codecov-src]: https://img.shields.io/codecov/c/gh/ucdjs/ucd?style=flat&colorA=18181B&colorB=4169E1
-[codecov-href]: https://codecov.io/gh/ucdjs/ucd

package/dist/index.d.mts

@@ -1,16 +1,12 @@
 import { DAG, FileContext, PipelineDefinition, PipelineGraph, PipelineGraphEdge } from "@ucdjs/pipelines-core";
 
 //#region src/builder.d.ts
-interface GraphBuilderOptions {
-  includeArtifacts?: boolean;
-}
 declare class PipelineGraphBuilder {
   #private;
   addSourceNode(version: string): string;
   addFileNode(file: FileContext): string;
   addRouteNode(routeId: string, version: string): string;
-  addArtifactNode(artifactId: string, version: string): string;
-  addOutputNode(outputIndex: number, version: string, property?: string): string;
+  addOutputNode(outputIndex: number, version: string, property?: string, outputId?: string, locator?: string): string;
   addEdge(from: string, to: string, type: PipelineGraphEdge["type"]): void;
   build(): PipelineGraph;
   clear(): void;
@@ -21,7 +17,7 @@ declare function createPipelineGraphBuilder(): PipelineGraphBuilder;
 /**
  * Build a pipeline graph from a pipeline definition and its DAG.
  * @param {PipelineDefinition} pipeline The pipeline definition to build the graph from.
- * @param {DAG} dag The DAG representing the dependencies between routes and artifacts in the pipeline.
+ * @param {DAG} dag The DAG representing the dependencies between routes in the pipeline.
  * @returns {PipelineGraph} The constructed pipeline graph.
  */
 declare function buildRouteGraph(pipeline: PipelineDefinition, dag: DAG): PipelineGraph;
@@ -47,4 +43,4 @@ declare function find(graph: PipelineGraph, nodeId: string): PipelineGraph["node
  */
 declare function findEdges(graph: PipelineGraph, from: string, to: string): PipelineGraph["edges"];
 //#endregion
-export { type GraphBuilderOptions, PipelineGraphBuilder, buildRouteGraph, createPipelineGraphBuilder, find, findEdges, toVisualTree };
+export { PipelineGraphBuilder, buildRouteGraph, createPipelineGraphBuilder, find, findEdges, toVisualTree };

package/dist/index.mjs

@@ -30,22 +30,22 @@ var PipelineGraphBuilder = class {
 		});
 		return id;
 	}
-	addArtifactNode(artifactId, version) {
-		const id = `artifact:${version}:${artifactId}`;
-		if (!this.#nodes.has(id)) this.#nodes.set(id, {
-			id,
-			type: "artifact",
-			artifactId
+	addOutputNode(outputIndex, version, property, outputId, locator) {
+		const id = `output:${version}:${outputId || locator ? `${outputId ?? "default"}:${locator ?? "unknown"}` : `${outputIndex}`}`;
+		const existing = this.#nodes.get(id);
+		if (existing?.type === "output") this.#nodes.set(id, {
+			...existing,
+			property: existing.property ?? property,
+			outputId: existing.outputId ?? outputId,
+			locator: existing.locator ?? locator
 		});
-		return id;
-	}
-	addOutputNode(outputIndex, version, property) {
-		const id = `output:${version}:${outputIndex}`;
-		if (!this.#nodes.has(id)) this.#nodes.set(id, {
+		else if (!existing) this.#nodes.set(id, {
 			id,
 			type: "output",
 			outputIndex,
-			property
+			property,
+			outputId,
+			locator
 		});
 		return id;
 	}
@@ -61,7 +61,7 @@ var PipelineGraphBuilder = class {
 	}
 	build() {
 		return {
-			nodes: Array.from(this.#nodes.values()),
+			nodes: [...this.#nodes.values()],
 			edges: [...this.#edges]
 		};
 	}
@@ -74,13 +74,12 @@ var PipelineGraphBuilder = class {
 function createPipelineGraphBuilder() {
 	return new PipelineGraphBuilder();
 }
-
 //#endregion
 //#region src/graph-utils.ts
 /**
 * Build a pipeline graph from a pipeline definition and its DAG.
 * @param {PipelineDefinition} pipeline The pipeline definition to build the graph from.
-* @param {DAG} dag The DAG representing the dependencies between routes and artifacts in the pipeline.
+* @param {DAG} dag The DAG representing the dependencies between routes in the pipeline.
 * @returns {PipelineGraph} The constructed pipeline graph.
 */
 function buildRouteGraph(pipeline, dag) {
@@ -93,10 +92,6 @@ function buildRouteGraph(pipeline, dag) {
 			const depNodeId = builder.addRouteNode(depId, "static");
 			builder.addEdge(depNodeId, currentRouteId, "provides");
 		}
-		for (const artifactId of routeNode.emittedArtifacts) {
-			const artifactNodeId = builder.addArtifactNode(artifactId, "static");
-			builder.addEdge(currentRouteId, artifactNodeId, "resolved");
-		}
 	}
 	return builder.build();
 }
@@ -164,6 +159,5 @@ function find(graph, nodeId) {
 function findEdges(graph, from, to) {
 	return graph.edges.filter((edge) => edge.from === from && edge.to === to);
 }
-
 //#endregion
-export { PipelineGraphBuilder, buildRouteGraph, createPipelineGraphBuilder, find, findEdges, toVisualTree };
+export { PipelineGraphBuilder, buildRouteGraph, createPipelineGraphBuilder, find, findEdges, toVisualTree };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ucdjs/pipelines-graph",
-  "version": "0.0.1-beta.7",
+  "version": "0.0.1-beta.8",
   "type": "module",
   "author": {
     "name": "Lucas Nørgård",
@@ -29,14 +29,14 @@
     "node": ">=24.13"
   },
   "dependencies": {
-    "@ucdjs/pipelines-core": "0.0.1-beta.7"
+    "@ucdjs/pipelines-core": "0.0.1-beta.8"
   },
   "devDependencies": {
-    "@luxass/eslint-config": "7.2.1",
-    "eslint": "10.0.2",
-    "publint": "0.3.17",
-    "tsdown": "0.20.3",
-    "typescript": "5.9.3",
+    "@luxass/eslint-config": "7.4.1",
+    "eslint": "10.1.0",
+    "publint": "0.3.18",
+    "tsdown": "0.21.4",
+    "typescript": "6.0.2",
     "@ucdjs-tooling/tsdown-config": "1.0.0",
     "@ucdjs-tooling/tsconfig": "1.0.0"
   },