Update visualization command.

Author: ioquatix

.gitignore

@@ -5,13 +5,3 @@
 /gems.locked
 /.covered.db
 /external
-
-kurocha
-dependency.svg
-
-# Test fixtures:
-fixtures/teapot/command/clone/
-fixtures/teapot/command/fetch/test-project/merged-lock.yml
-fixtures/teapot/command/fetch/test-project/teapot/
-fixtures/teapot/command/fetch/test-project/test-lock.yml
-fixtures/teapot/run/

fixtures/teapot/command/visualize/test-project/teapot.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2026, by Samuel Williams.
+
+teapot_version "2.0"
+
+define_project "test-project" do |project|
+	project.title = "Test Project"
+	project.license = "MIT"
+end
+
+define_configuration "development" do |configuration|
+	configuration.targets[:build] << "test-target"
+end
+
+define_target "test-target" do |target|
+	target.depends "library"
+	target.depends "utilities"
+end
+
+define_target "library" do |target|
+	target.depends "base"
+end
+
+define_target "utilities" do |target|
+end
+
+define_target "base" do |target|
+end

fixtures/teapot/command/visualize/test-project/teapot/packages/development/base-package/teapot.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2026, by Samuel Williams.
+
+teapot_version "2.0"
+
+define_project "base-package" do |project|
+	project.title = "Base Package"
+	project.license = "MIT"
+end
+
+define_configuration "development" do |configuration|
+end
+
+define_target "base-target" do |target|
+	target.provides "Library/Base"
+end

fixtures/teapot/command/visualize/test-project/teapot/packages/development/external-library/teapot.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2026, by Samuel Williams.
+
+teapot_version "2.0"
+
+define_project "external-library" do |project|
+	project.title = "External Library"
+	project.license = "MIT"
+end
+
+define_configuration "development" do |configuration|
+	configuration.require "base-package"
+end
+
+define_target "external-library-target" do |target|
+	target.provides "Library/External"
+end

fixtures/teapot/command/visualize/test-project/teapot/packages/development/utilities-package/teapot.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2026, by Samuel Williams.
+
+teapot_version "2.0"
+
+define_project "utilities-package" do |project|
+	project.title = "Utilities Package"
+	project.license = "MIT"
+end
+
+define_configuration "development" do |configuration|
+	configuration.require "base-package"
+end
+
+define_target "utilities-target" do |target|
+	target.provides "Library/Utilities"
+end

fixtures/teapot/command/visualize_context.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2026, by Samuel Williams.
+
+require "sus/shared"
+require "build/files"
+
+require "sus/fixtures/temporary_directory_context"
+
+module Teapot
+	module Command
+		VisualizeContext = Sus::Shared("a visualize") do
+			include Sus::Fixtures::TemporaryDirectoryContext
+			
+			let(:project_path) {::Build::Files::Path.new(File.expand_path("visualize/test-project", __dir__))}
+		end
+	end
+end

fixtures/teapot/run/test-project/teapot.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+define_project "test-project" do |project|
+	project.title = "Test Project"
+	project.license = "MIT"
+end
+
+define_target "test-target" do |target|
+	target.depends "library"
+end
+
+define_target "library" do |target|
+end

lib/teapot/command/visualize.rb

@@ -3,56 +3,120 @@
 # Released under the MIT License.
 # Copyright, 2017-2026, by Samuel Williams.
 
+require "samovar"
 require_relative "selection"
-require "graphviz"
+require "build/controller"
 
 module Teapot
 	module Command
-		# A command to visualize the dependency graph.
-		class Visualize < Selection
-			self.description = "Generate a picture of the dependency graph."
+		# A command to visualize dependency graphs.
+		class Visualize < Samovar::Command
+			self.description = "Generate visualizations of package and target dependencies."
 
-			options do
-				option "-o/--output-path <path>", "The output path for the visualization.", default: "dependency.svg"
-				option "-d/--dependency-name <name>", "Show the partial chain for the given named dependency."
-			end
-			
-			# Get the dependency names to visualize.
-			# @returns [Array(String)] The dependency names.
-			def dependency_names
-				@targets || []
-			end
-			
-			# Get the specific dependency name to visualize.
-			# @returns [String | Nil] The dependency name.
-			def dependency_name
-				@options[:dependency_name]
+			# Visualize package-level dependencies.
+			class Packages < Selection
+				self.description = "Visualize package-level dependencies from configuration.require."
+				
+				options do
+					option "-o/--output-path <path>", "The output path for the visualization."
+					option "-d/--dependency-name <name>", "Show the partial chain for the given named dependency."
+				end
+				
+				# Get the specific dependency name to visualize.
+				# @returns [String | Nil] The dependency name.
+				def dependency_name
+					@options[:dependency_name]
+				end
+				
+				# Process and generate the package dependency visualization.
+				# @parameter selection [Select] The selection to visualize.
+				# @returns [String] The generated Mermaid diagram.
+				def process(selection)
+					chain = selection.chain
+					
+					if dependency_name
+						provider = selection.dependencies[dependency_name]
+						chain = chain.partial(provider)
+					end
+					
+					visualization = ::Build::Dependency::Visualization.new
+					diagram = visualization.generate(chain)
+					
+					if output_path = @options[:output_path]
+						File.write(output_path, diagram)
+					else
+						$stdout.puts diagram
+					end
+					
+					return diagram
+				end
 			end
 
-			# Process and generate the visualization.
-			# @parameter selection [Select] The selection to visualize.
-			# @returns [Graphviz::Graph] The generated graph.
-			def process(selection)
-				context = selection.context
-				chain = selection.chain
+			# Visualize target-level dependencies.
+			class Targets < Selection
+				self.description = "Visualize target-level dependencies from target.depends."
 
-				if dependency_name
-					provider = selection.dependencies[dependency_name]
-					
-					chain = chain.partial(provider)
+				options do
+					option "-o/--output-path <path>", "The output path for the visualization."
 				end
 
-				visualization = ::Build::Dependency::Visualization.new
+				# Process and generate the target dependency visualization.
+				# @parameter selection [Select] The selection to visualize.
+				# @returns [String] The generated Mermaid diagram.
+				def process(selection)
+					lines = ["flowchart LR"]
+					lines << ""
+					
+					# Build the graph from all targets in the selection
+					# The selection contains all targets loaded from packages
+					selection.targets.each do |name, target|
+						target.dependencies.each do |dependency|
+							dependency_name = dependency.name.to_s
+							
+							# Create edge from target to its dependency
+							if dependency.private?
+								lines << "    #{sanitize_id(name)}[#{name}] -.-> #{sanitize_id(dependency_name)}[#{dependency_name}]"
+							else
+								lines << "    #{sanitize_id(name)}[#{name}] --> #{sanitize_id(dependency_name)}[#{dependency_name}]"
+							end
+						end
+					end
+					
+					diagram = lines.join("\n")
+					
+					if output_path = @options[:output_path]
+						File.write(output_path, diagram)
+					else
+						$stdout.puts diagram
+					end
+					
+					return diagram
+				end
 
-				graph = visualization.generate(chain)
+				private
 
-				if output_path = @options[:output_path]
-					Graphviz.output(graph, path: output_path, format: :svg)
-				else
-					$stdout.puts graph.to_dot
+				# Convert a name to a valid Mermaid node ID.
+				# @parameter name [String] The name to sanitize.
+				# @returns [String] A sanitized identifier safe for use in Mermaid diagrams.
+				def sanitize_id(name)
+					name.to_s.gsub(/[^a-zA-Z0-9_]/, "_")
 				end
-				
-				return graph
+			end
+			
+			nested :command, {
+				"packages" => Packages,
+				"targets" => Targets,
+			}, default: "packages"
+			
+			# Delegate context to parent Top command.
+			# @returns [Context] The project context.
+			def context
+				parent.context
+			end
+			
+			# Execute the visualize command.
+			def call
+				@command.call
 			end
 		end
 	end

releases.md

@@ -1,5 +1,9 @@
 # Releases
 
+## Unreleased
+
+  - `teapot visualize` has two new sub-commands: `packages` and `targets`. The former visualizes the dependency graph of packages, while the latter visualizes the dependency graph of targets. Both sub-commands output Mermaid diagrams, which can be rendered using Mermaid Live Editor or other Mermaid-compatible tools.
+
 ## v3.6.0
 
   - Update dependencies.

teapot.gemspec

@@ -26,7 +26,7 @@ Gem::Specification.new do |spec|
 	spec.required_ruby_version = ">= 3.3"
 
 	spec.add_dependency "build", "~> 2.4"
-	spec.add_dependency "build-dependency", "~> 1.4"
+	spec.add_dependency "build-dependency", "~> 1.6"
 	spec.add_dependency "build-environment", "~> 1.10"
 	spec.add_dependency "build-files", "~> 1.8"
 	spec.add_dependency "build-files-monitor", "~> 0.4"