Dprecate TopologicalShapeSort

This deprecates TopologicalShapeSort in favor of DependencyGraph.
The internal implementation is left alone because it does not
inherently enqueue dependencies like DependencyGraph does. This
results in TopologicalShapeSort throwing a cycle exception when
dependencies are missing, which is a behavior that some may
rely on.

Author: JordonPhillips

.changes/next-release/feature-e0f8e99e0b8a04946095a8711bd3e921405d9a53.json

@@ -0,0 +1,7 @@
+{
+  "type": "feature",
+  "description": "Deprecated `TopologicalShapeSort` in favor of `DependencyGraph`.",
+  "pull_requests": [
+    "[#2774](https://github.com/smithy-lang/smithy/pull/2774)"
+  ]
+}

smithy-model/src/main/java/software/amazon/smithy/model/loader/TopologicalShapeSort.java

@@ -21,9 +21,10 @@
 /**
  * Topologically sorts shapes based on their dependencies (i.e., mixins).
  *
- * <p>While this class is reusable, it is also stateful; shapes and edges
- * are enqueued, and when sorted, all shapes and edges are dequeued.
+ * <p>Deprecated in favor of {@link software.amazon.smithy.utils.DependencyGraph},
+ * which is more generic and less stateful.
  */
+@Deprecated
 public final class TopologicalShapeSort {
 
     private final Map<ShapeId, Set<ShapeId>> forwardDependencies = new HashMap<>();