Function FormatLayerGraph

internal/layergraph/format.go:128–172

FormatLayerGraph renders the full layer graph as a Mermaid flowchart TD with entity-encoded labels. Intentional divergence from .repos reference: this output format includes cross-file location annotations (e.g., "_in simple.ts at ln 6 col 19_") on nodes originating from a different source file. The

(
	c *checker.Checker,
	layerGraph *graph.Graph[LayerGraphNodeInfo, LayerGraphEdgeInfo],
	sf *ast.SourceFile,
)

// including them in nested, outline, and quickinfo formats. The Go version adds them here as an
// enhancement to help users locate cross-file nodes in the flat graph.
func FormatLayerGraph(
	c *checker.Checker,
	layerGraph *graph.Graph[LayerGraphNodeInfo, LayerGraphEdgeInfo],
	sf *ast.SourceFile,
) string {
	var lines []string
	lines = append(lines, "flowchart TD")

	// Nodes in index order.
	for idx, nodeInfo := range layerGraph.Nodes() {
		nodeSourceFile := getNodeSourceFile(nodeInfo.Node)
		text := getNodeText(nodeInfo.Node, nodeSourceFile)

		var provides []string
		for _, t := range nodeInfo.Provides {
			provides = append(provides, getTypeDisplayName(c, t))
		}
		var requires []string
		for _, t := range nodeInfo.Requires {
			requires = append(requires, getTypeDisplayName(c, t))
		}

		label := text + "\nprovides: " + strings.Join(provides, ", ") + "\nrequires: " + strings.Join(requires, ", ")
		if nodeSourceFile != nil && nodeSourceFile != sf {
			label += "\n_" + formatLocation(nodeInfo.Node, sf) + "_"
		}
		label = mermaidEntityEncode(label)
		label = strings.ReplaceAll(label, "\n", "<br/>")
		label = mermaidEscapeOutputLabel(label)
		lines = append(lines, fmt.Sprintf("  %d[\"%s\"]", idx, label))
	}

	// Edges in index order.
	for _, edge := range layerGraph.Edges() {
		jsonBytes, err := json.Marshal(edge.Data)
		if err != nil {
			continue
		}
		edgeLabel := mermaidEntityEncode(string(jsonBytes))
		edgeLabel = mermaidEscapeOutputLabel(edgeLabel)
		lines = append(lines, fmt.Sprintf("  %d -->|\"%s\"| %d", edge.Source, edgeLabel, edge.Target))
	}

	return strings.Join(lines, "\n")
}

// FormatNestedLayerGraph renders the layer graph as a Mermaid flowchart TB with nested subgraphs.
func FormatNestedLayerGraph(