From 3dedccb561b5b8d80f84ff870082d52b84fa22c7 Mon Sep 17 00:00:00 2001
From: Jordan Parker <6415727+byjpr@users.noreply.github.com>
Date: Fri, 22 Apr 2022 12:23:51 +0000
Subject: [PATCH 01/10] Init catalogue plugins

---
 .../extendable_sort/sort/by_code_directory.ex | 25 +++++++++++++++++++
 .../extendable_sort/sort/by_module_name.ex    | 10 ++++++++
 .../catalogue/extendable_sort/sort/by_tags.ex | 16 ++++++++++++
 3 files changed, 51 insertions(+)
 create mode 100644 lib/surface/catalogue/extendable_sort/sort/by_code_directory.ex
 create mode 100644 lib/surface/catalogue/extendable_sort/sort/by_module_name.ex
 create mode 100644 lib/surface/catalogue/extendable_sort/sort/by_tags.ex

diff --git a/lib/surface/catalogue/extendable_sort/sort/by_code_directory.ex b/lib/surface/catalogue/extendable_sort/sort/by_code_directory.ex
new file mode 100644
index 0000000..f894b75
--- /dev/null
+++ b/lib/surface/catalogue/extendable_sort/sort/by_code_directory.ex
@@ -0,0 +1,25 @@
+defmodule Surface.Catalogue.ExtendableSort.Sort.ByCodeDirectory do
+  @moduledoc """
+  Sort Module Maps by Code Directory.
+
+  for example if you have a code structure inside `lib`
+  you would see the same structure reflected in the Component Library.
+
+  ```
+    surface
+      button
+        buttongroup
+        button-small
+        button-large
+      pills
+      text
+        paragraph
+        header
+        codeblock
+        pre
+  ```
+  """
+
+  def sort(components) do
+  end
+end
diff --git a/lib/surface/catalogue/extendable_sort/sort/by_module_name.ex b/lib/surface/catalogue/extendable_sort/sort/by_module_name.ex
new file mode 100644
index 0000000..23e480a
--- /dev/null
+++ b/lib/surface/catalogue/extendable_sort/sort/by_module_name.ex
@@ -0,0 +1,10 @@
+defmodule Surface.Catalogue.ExtendableSort.Sort.ByModule do
+  @moduledoc """
+  Sort Module Maps by Module Name.
+
+  Default Surface sorting.
+  """
+
+  def sort(components) do
+  end
+end
diff --git a/lib/surface/catalogue/extendable_sort/sort/by_tags.ex b/lib/surface/catalogue/extendable_sort/sort/by_tags.ex
new file mode 100644
index 0000000..7dc8913
--- /dev/null
+++ b/lib/surface/catalogue/extendable_sort/sort/by_tags.ex
@@ -0,0 +1,16 @@
+defmodule Surface.Catalogue.ExtendableSort.Sort.ByTags do
+  @moduledoc """
+  Sort Module Maps by Tags.
+
+  Module will be sorted into the catalouge that is titled in `@module_parent`
+
+  ```
+  defmodule SurfaceUI.Example do
+    @module_parent "paragraph"
+  end
+  ```
+  """
+
+  def sort(components) do
+  end
+end

From 4569cd68407e03e0bd032726f5538f09955cc2aa Mon Sep 17 00:00:00 2001
From: Jordan Parker <6415727+byjpr@users.noreply.github.com>
Date: Fri, 22 Apr 2022 12:24:11 +0000
Subject: [PATCH 02/10] =?UTF-8?q?=E2=9C=A8=20first=20wip?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../catalogue/components/component_tree.ex    |   2 +-
 .../components/extendable_sort/item.ex        | 100 ++++++++++++++++++
 .../components/extendable_sort/tree.ex        |  21 ++++
 lib/surface/catalogue/extendable_sort.ex      |  15 +++
 .../catalogue/extendable_sort/builder.ex      |  55 ++++++++++
 .../catalogue/extendable_sort/category.ex     |   3 +
 .../catalogue/extendable_sort/map_handler.ex  |  32 ++++++
 .../catalogue/extendable_sort/module.ex       |   3 +
 lib/surface/catalogue/live/page_live.ex       |   9 +-
 9 files changed, 236 insertions(+), 4 deletions(-)
 create mode 100644 lib/surface/catalogue/components/extendable_sort/item.ex
 create mode 100644 lib/surface/catalogue/components/extendable_sort/tree.ex
 create mode 100644 lib/surface/catalogue/extendable_sort.ex
 create mode 100644 lib/surface/catalogue/extendable_sort/builder.ex
 create mode 100644 lib/surface/catalogue/extendable_sort/category.ex
 create mode 100644 lib/surface/catalogue/extendable_sort/map_handler.ex
 create mode 100644 lib/surface/catalogue/extendable_sort/module.ex

diff --git a/lib/surface/catalogue/components/component_tree.ex b/lib/surface/catalogue/components/component_tree.ex
index b01093b..3b91e49 100644
--- a/lib/surface/catalogue/components/component_tree.ex
+++ b/lib/surface/catalogue/components/component_tree.ex
@@ -7,7 +7,7 @@ defmodule Surface.Catalogue.Components.ComponentTree do
 
   prop selected_component, :string
   prop single_catalogue?, :boolean
-  prop components, :map
+  prop components, :any
 
   def render(assigns) do
     ~F"""
diff --git a/lib/surface/catalogue/components/extendable_sort/item.ex b/lib/surface/catalogue/components/extendable_sort/item.ex
new file mode 100644
index 0000000..9fdbe0f
--- /dev/null
+++ b/lib/surface/catalogue/components/extendable_sort/item.ex
@@ -0,0 +1,100 @@
+defmodule Surface.Catalogue.Components.ExtendableSort.Item do
+  @moduledoc false
+
+  use Surface.LiveComponent
+
+  alias Surface.Catalogue.ExtendableSort
+  alias Surface.Components.LivePatch
+
+  prop selected_component, :string
+  prop single_catalogue?, :boolean
+  prop components, :map
+
+  def render(assigns, node) when is_list(node) do
+    ~F"""
+      {#for item <- node}
+        {#if item.__struct__ == Surface.Catalogue.ExtendableSort.Category}
+          <ul>
+            {render(assigns, item)}
+          </ul>
+        {#else}
+          {render(assigns, item)}
+        {/if}
+      {#else}
+        <div></div>
+      {/for}
+    """
+  end
+
+  def render(assigns, %ExtendableSort.Category{name: "Root"} = node) do
+    ~F"""
+    <ul class={""}>
+      {render(assigns, node.children)}
+    </ul>
+    """
+  end
+
+  def render(assigns, %ExtendableSort.Category{} = node) do
+    ~F"""
+    <li>
+      <a href="#" onclick="toggleNode(this)">
+        <span class="icon">
+          <i class={:far, "fa-folder-open"}></i>
+        </span>
+        {node.name}
+      </a>
+      <ul>
+        {render(assigns, node.children)}
+      </ul>
+    </li>
+    """
+  end
+
+  def render(assigns, %ExtendableSort.Module{} = node) do
+    ~F"""
+    <li>
+      <LivePatch
+        to={@socket.router.__helpers__().live_path(@socket, Surface.Catalogue.PageLive, inspect(node.module))}>
+        <span class="icon">
+          <i class={"far fa-file-code"}></i>
+        </span> {node.name}
+      </LivePatch>
+    </li>
+    """
+  end
+
+  #
+  # Private
+  #
+
+  defp component_icon(type) do
+    case type do
+      Surface.MacroComponent ->
+        "fas fa-hashtag"
+
+      _ ->
+        "far fa-file-code"
+    end
+  end
+
+  defp selected_component?(mod_path, component) do
+    component == Enum.join(mod_path, ".")
+  end
+
+  defp has_child_selected?(_mod_path, nil) do
+    false
+  end
+
+  defp has_child_selected?(mod_path, component) do
+    String.starts_with?(component, Enum.join(mod_path, ".") <> ".")
+  end
+
+  defp show_nodes?(_parent_keys = [], _selected_component, _single_catalogue?) do
+    true
+  end
+
+  defp show_nodes?(parent_keys, selected_component, single_catalogue?) do
+    has_child_selected?(parent_keys, selected_component) or
+      (single_catalogue? and length(parent_keys) == 1)
+  end
+end
diff --git a/lib/surface/catalogue/components/extendable_sort/tree.ex b/lib/surface/catalogue/components/extendable_sort/tree.ex
new file mode 100644
index 0000000..bf4d1ae
--- /dev/null
+++ b/lib/surface/catalogue/components/extendable_sort/tree.ex
@@ -0,0 +1,21 @@
+defmodule Surface.Catalogue.Components.ExtendableSort.Tree do
+  @moduledoc false
+
+  use Surface.LiveComponent
+
+  alias Surface.Components.LivePatch
+
+  alias Surface.Catalogue.ExtendableSort
+
+  prop selected_component, :string
+  prop single_catalogue?, :boolean
+  prop components, :any
+
+  def render(assigns) do
+    ~F"""
+    <div class={"menu-list"}>
+      {Surface.Catalogue.Components.ExtendableSort.Item.render(assigns, @components)}
+    </div>
+    """
+  end
+end
diff --git a/lib/surface/catalogue/extendable_sort.ex b/lib/surface/catalogue/extendable_sort.ex
new file mode 100644
index 0000000..ca02450
--- /dev/null
+++ b/lib/surface/catalogue/extendable_sort.ex
@@ -0,0 +1,15 @@
+defmodule Surface.Catalogue.ExtendableSort do
+  def handle(surface_ast) do
+    surface_ast
+    |> Surface.Catalogue.ExtendableSort.MapHandler.to_extendable_sort()
+    |> Surface.Catalogue.ExtendableSort.Builder.from_map()
+  end
+
+  def get_sort_config do
+    Application.get_env(:surface_catalogue, :sort, [
+      Surface.Catalogue.ExtendableSort.Sort.ByCodeDirectory,
+      Surface.Catalogue.ExtendableSort.Sort.ByModule,
+      Surface.Catalogue.ExtendableSort.Sort.ByTags
+    ])
+  end
+end
diff --git a/lib/surface/catalogue/extendable_sort/builder.ex b/lib/surface/catalogue/extendable_sort/builder.ex
new file mode 100644
index 0000000..01f49e5
--- /dev/null
+++ b/lib/surface/catalogue/extendable_sort/builder.ex
@@ -0,0 +1,55 @@
+defmodule Surface.Catalogue.ExtendableSort.Builder do
+  alias Surface.Catalogue.ExtendableSort
+
+  def from_map(children) when is_list(children) do
+    Enum.map(children, fn x -> map_inspector(x) end) |> List.flatten()
+  end
+
+  def from_map(module) do
+    map_inspector(module)
+  end
+
+  def map_inspector(map) do
+    case {is_module?(map), has_children?(map)} do
+      # not module, has children
+      {false, true} ->
+        [cast_to_category(map)]
+
+      # is module, has children
+      {true, true} ->
+        [cast_to_module(map), cast_to_category(map)]
+
+      # is module, no children
+      {true, false} ->
+        [cast_to_module(map)]
+
+      # everything else would be pointless to include
+      {_, _} ->
+        []
+    end
+  end
+
+  defp cast_to_category(map) do
+    {_, new_map} =
+      map
+      # categories don't have modules
+      |> Map.drop([:module])
+      |> Map.get_and_update!(:children, fn current_value ->
+        {current_value, from_map(current_value)}
+      end)
+
+    struct(ExtendableSort.Category, new_map)
+  end
+
+  defp cast_to_module(map) do
+    # modules don't have children
+    new_map = map |> Map.drop([:children])
+    struct(ExtendableSort.Module, new_map)
+  end
+
+  defp is_module?(%{type: type}) when type != :none, do: true
+  defp is_module?(_), do: false
+
+  defp has_children?(%{children: [_head | _tail]}), do: true
+  defp has_children?(_), do: false
+end
diff --git a/lib/surface/catalogue/extendable_sort/category.ex b/lib/surface/catalogue/extendable_sort/category.ex
new file mode 100644
index 0000000..bc3feff
--- /dev/null
+++ b/lib/surface/catalogue/extendable_sort/category.ex
@@ -0,0 +1,3 @@
+defmodule Surface.Catalogue.ExtendableSort.Category do
+  defstruct [:name, :parent, :children]
+end
diff --git a/lib/surface/catalogue/extendable_sort/map_handler.ex b/lib/surface/catalogue/extendable_sort/map_handler.ex
new file mode 100644
index 0000000..ca8b3d3
--- /dev/null
+++ b/lib/surface/catalogue/extendable_sort/map_handler.ex
@@ -0,0 +1,32 @@
+defmodule Surface.Catalogue.ExtendableSort.MapHandler do
+  def to_extendable_sort(children, parent \\ "Root", parent_path \\ ["Root"]) do
+    for {key, value} <- Enum.sort(children) do
+      generated_chain = parent_path ++ [key]
+      module = generated_chain |> remove_root |> Module.concat()
+      type = module |> component_type
+
+      %{
+        name: key,
+        children: to_extendable_sort(value, key, generated_chain),
+        parent_path: parent_path,
+        module: module,
+        type: type,
+        parent: parent
+      }
+    end
+  end
+
+  defp remove_root(["Root" | rest]), do: rest
+  defp remove_root(rest), do: rest
+
+  defp component_type(module) do
+    with true <- function_exported?(module, :component_type, 0),
+         component_type = module.component_type(),
+         true <- component_type != Surface.LiveView do
+      component_type
+    else
+      _ ->
+        :none
+    end
+  end
+end
diff --git a/lib/surface/catalogue/extendable_sort/module.ex b/lib/surface/catalogue/extendable_sort/module.ex
new file mode 100644
index 0000000..79fd0b8
--- /dev/null
+++ b/lib/surface/catalogue/extendable_sort/module.ex
@@ -0,0 +1,3 @@
+defmodule Surface.Catalogue.ExtendableSort.Module do
+  defstruct [:name, :module, :children]
+end
diff --git a/lib/surface/catalogue/live/page_live.ex b/lib/surface/catalogue/live/page_live.ex
index 9c12f2e..aecfeba 100644
--- a/lib/surface/catalogue/live/page_live.ex
+++ b/lib/surface/catalogue/live/page_live.ex
@@ -12,7 +12,7 @@ defmodule Surface.Catalogue.PageLive do
   data component_module, :module
   data has_example?, :boolean
   data has_playground?, :boolean
-  data components, :map, default: %{}
+  data components, :any, default: []
   data action, :string
   data examples_and_playgrounds, :map, default: %{}
   data examples, :list, default: []
@@ -29,13 +29,15 @@ defmodule Surface.Catalogue.PageLive do
       if connected?(socket) do
         {components, examples_and_playgrounds} = Util.get_components_info()
 
+        extendable_sort_components = components |> Surface.Catalogue.ExtendableSort.handle()
+
         catalogues = Application.get_env(:surface_catalogue, :catalogues) || []
         home_view = Application.get_env(:surface_catalogue, :home_view)
         single_catalogue? = length(catalogues) == 1
 
         socket
         |> maybe_assign_window_id(params, session)
-        |> assign(:components, components)
+        |> assign(:components, extendable_sort_components)
         |> assign(:single_catalogue?, single_catalogue?)
         |> assign(:home_view, home_view)
         |> assign(:examples_and_playgrounds, examples_and_playgrounds)
@@ -76,7 +78,7 @@ defmodule Surface.Catalogue.PageLive do
       <div class="sidebar-bg"/>
       <div class="container is-fullhd">
         <section class="main-content columns">
-          <ComponentTree
+          <Surface.Catalogue.Components.ExtendableSort.Tree
             id="component-tree"
             components={@components}
             selected_component={@component_name}
@@ -86,6 +88,7 @@ defmodule Surface.Catalogue.PageLive do
             <div :if={!@component_module and @home_view}>
               {live_render(@socket, @home_view, id: "home_view")}
             </div>
+
             <div :if={!@component_module and !@home_view} class="columns is-centered is-vcentered is-mobile" style="height: 300px">
               <div class="column is-narrow has-text-centered subtitle has-text-grey">
                 No component selected

From 183d5bc64cee69886389e5ac9b199690c92f45a0 Mon Sep 17 00:00:00 2001
From: Jordan Parker <6415727+byjpr@users.noreply.github.com>
Date: Sat, 23 Apr 2022 14:13:21 +0000
Subject: [PATCH 03/10] Call each function

---
 lib/surface/catalogue/extendable_sort.ex | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/lib/surface/catalogue/extendable_sort.ex b/lib/surface/catalogue/extendable_sort.ex
index ca02450..ef4345b 100644
--- a/lib/surface/catalogue/extendable_sort.ex
+++ b/lib/surface/catalogue/extendable_sort.ex
@@ -12,4 +12,26 @@ defmodule Surface.Catalogue.ExtendableSort do
       Surface.Catalogue.ExtendableSort.Sort.ByTags
     ])
   end
+
+  def run_extendable(ast, module) do
+    case apply(module, :apply, [ast]) do
+      {:ok, returned_ast} ->
+        {:ok, returned_ast}
+
+      {:error, _message} ->
+        {:error, ast}
+
+      _ ->
+        {:error, ast}
+    end
+  end
+
+  def apply_sort_list(init_ast, [head | tail] = _sort_modules) do
+    {_resp_type, ast} = run_extendable(init_ast, head)
+    apply_sort_list(ast, tail)
+  end
+
+  def apply_sort_list(ast, [] = _sort_modules) do
+    ast
+  end
 end

From 988ecebe87da5ddd8c4153339c09a5071e2512ba Mon Sep 17 00:00:00 2001
From: Jordan Parker <6415727+byjpr@users.noreply.github.com>
Date: Sat, 23 Apr 2022 14:13:34 +0000
Subject: [PATCH 04/10] Rename to adapters

---
 lib/surface/catalogue/extendable_sort.ex | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/lib/surface/catalogue/extendable_sort.ex b/lib/surface/catalogue/extendable_sort.ex
index ef4345b..b4d9261 100644
--- a/lib/surface/catalogue/extendable_sort.ex
+++ b/lib/surface/catalogue/extendable_sort.ex
@@ -1,15 +1,17 @@
 defmodule Surface.Catalogue.ExtendableSort do
-  def handle(surface_ast) do
+  def handle(surface_ast, config \\ []) do
     surface_ast
     |> Surface.Catalogue.ExtendableSort.MapHandler.to_extendable_sort()
     |> Surface.Catalogue.ExtendableSort.Builder.from_map()
+    |> apply_sort_list(get_sort_config())
   end
 
   def get_sort_config do
     Application.get_env(:surface_catalogue, :sort, [
-      Surface.Catalogue.ExtendableSort.Sort.ByCodeDirectory,
-      Surface.Catalogue.ExtendableSort.Sort.ByModule,
-      Surface.Catalogue.ExtendableSort.Sort.ByTags
+      Surface.Catalogue.ExtendableSort.Adapters.CategoryFirst,
+      Surface.Catalogue.ExtendableSort.Adapters.ByCodeDirectory,
+      Surface.Catalogue.ExtendableSort.Adapters.ByModuleABC,
+      Surface.Catalogue.ExtendableSort.Adapters.ByTags
     ])
   end
 

From 991fb48cf9a28f77808d27b9eb91f71c3e0fc3c7 Mon Sep 17 00:00:00 2001
From: Jordan Parker <6415727+byjpr@users.noreply.github.com>
Date: Sat, 23 Apr 2022 14:13:53 +0000
Subject: [PATCH 05/10] Simplify rendering code

---
 lib/surface/catalogue/components/extendable_sort/item.ex | 8 ++------
 1 file changed, 2 insertions(+), 6 deletions(-)

diff --git a/lib/surface/catalogue/components/extendable_sort/item.ex b/lib/surface/catalogue/components/extendable_sort/item.ex
index 9fdbe0f..545b484 100644
--- a/lib/surface/catalogue/components/extendable_sort/item.ex
+++ b/lib/surface/catalogue/components/extendable_sort/item.ex
@@ -13,13 +13,9 @@ defmodule Surface.Catalogue.Components.ExtendableSort.Item do
   def render(assigns, node) when is_list(node) do
     ~F"""
       {#for item <- node}
-        {#if item.__struct__ == Surface.Catalogue.ExtendableSort.Category}
-          <ul>
-            {render(assigns, item)}
-          </ul>
-        {#else}
+
           {render(assigns, item)}
-        {/if}
+
       {#else}
         <div></div>
       {/for}

From 4d0fc57480d997e3c06b24c19782aa15a60170fc Mon Sep 17 00:00:00 2001
From: Jordan Parker <6415727+byjpr@users.noreply.github.com>
Date: Sat, 23 Apr 2022 14:14:29 +0000
Subject: [PATCH 06/10] Create adapter callbacks

---
 .../catalogue/extendable_sort/adapters.ex     | 24 +++++++++++++++++++
 1 file changed, 24 insertions(+)
 create mode 100644 lib/surface/catalogue/extendable_sort/adapters.ex

diff --git a/lib/surface/catalogue/extendable_sort/adapters.ex b/lib/surface/catalogue/extendable_sort/adapters.ex
new file mode 100644
index 0000000..48c7880
--- /dev/null
+++ b/lib/surface/catalogue/extendable_sort/adapters.ex
@@ -0,0 +1,24 @@
+defmodule Surface.Catalogue.ExtendableSort.Adapter do
+  @type error :: Exception.t() | String.t()
+
+  @doc """
+  Selective filter `children` in a nested data structure and
+  apply `sort/1` to them.
+  """
+  @callback apply(ast :: any) :: {:ok, any} | {:error, error}
+
+  @doc """
+  Sorting rules
+
+  ```elixir
+  Enum.sort_by(points, fn(p) -> p.points end)
+  ```
+
+  ```elixir
+  Enum.sort_by(points, fn(p) -> {p.points, p.coordinate} end)
+  ```
+
+  https://stackoverflow.com/questions/48310861/sort-list-of-maps-based-on-a-value-within-the-map
+  """
+  @callback sort(ast :: any) :: {:ok, any} | {:error, error}
+end

From 3cc8ef1440e38aadba34caf39c6aa55e16953eef Mon Sep 17 00:00:00 2001
From: Jordan Parker <6415727+byjpr@users.noreply.github.com>
Date: Sat, 23 Apr 2022 14:15:03 +0000
Subject: [PATCH 07/10] Remove sort files

---
 .../extendable_sort/sort/by_code_directory.ex | 25 -------------------
 .../extendable_sort/sort/by_module_name.ex    | 10 --------
 .../catalogue/extendable_sort/sort/by_tags.ex | 16 ------------
 3 files changed, 51 deletions(-)
 delete mode 100644 lib/surface/catalogue/extendable_sort/sort/by_code_directory.ex
 delete mode 100644 lib/surface/catalogue/extendable_sort/sort/by_module_name.ex
 delete mode 100644 lib/surface/catalogue/extendable_sort/sort/by_tags.ex

diff --git a/lib/surface/catalogue/extendable_sort/sort/by_code_directory.ex b/lib/surface/catalogue/extendable_sort/sort/by_code_directory.ex
deleted file mode 100644
index f894b75..0000000
--- a/lib/surface/catalogue/extendable_sort/sort/by_code_directory.ex
+++ /dev/null
@@ -1,25 +0,0 @@
-defmodule Surface.Catalogue.ExtendableSort.Sort.ByCodeDirectory do
-  @moduledoc """
-  Sort Module Maps by Code Directory.
-
-  for example if you have a code structure inside `lib`
-  you would see the same structure reflected in the Component Library.
-
-  ```
-    surface
-      button
-        buttongroup
-        button-small
-        button-large
-      pills
-      text
-        paragraph
-        header
-        codeblock
-        pre
-  ```
-  """
-
-  def sort(components) do
-  end
-end
diff --git a/lib/surface/catalogue/extendable_sort/sort/by_module_name.ex b/lib/surface/catalogue/extendable_sort/sort/by_module_name.ex
deleted file mode 100644
index 23e480a..0000000
--- a/lib/surface/catalogue/extendable_sort/sort/by_module_name.ex
+++ /dev/null
@@ -1,10 +0,0 @@
-defmodule Surface.Catalogue.ExtendableSort.Sort.ByModule do
-  @moduledoc """
-  Sort Module Maps by Module Name.
-
-  Default Surface sorting.
-  """
-
-  def sort(components) do
-  end
-end
diff --git a/lib/surface/catalogue/extendable_sort/sort/by_tags.ex b/lib/surface/catalogue/extendable_sort/sort/by_tags.ex
deleted file mode 100644
index 7dc8913..0000000
--- a/lib/surface/catalogue/extendable_sort/sort/by_tags.ex
+++ /dev/null
@@ -1,16 +0,0 @@
-defmodule Surface.Catalogue.ExtendableSort.Sort.ByTags do
-  @moduledoc """
-  Sort Module Maps by Tags.
-
-  Module will be sorted into the catalouge that is titled in `@module_parent`
-
-  ```
-  defmodule SurfaceUI.Example do
-    @module_parent "paragraph"
-  end
-  ```
-  """
-
-  def sort(components) do
-  end
-end

From 4900a12be3ef2177e09d17ec3c43f2388eb2077e Mon Sep 17 00:00:00 2001
From: Jordan Parker <6415727+byjpr@users.noreply.github.com>
Date: Sat, 23 Apr 2022 14:15:25 +0000
Subject: [PATCH 08/10] Create `category_first` strategy with recurrsive sorts

---
 .../adapters/category_first.ex                | 32 +++++++++++++++++++
 1 file changed, 32 insertions(+)
 create mode 100644 lib/surface/catalogue/extendable_sort/adapters/category_first.ex

diff --git a/lib/surface/catalogue/extendable_sort/adapters/category_first.ex b/lib/surface/catalogue/extendable_sort/adapters/category_first.ex
new file mode 100644
index 0000000..ec87dbc
--- /dev/null
+++ b/lib/surface/catalogue/extendable_sort/adapters/category_first.ex
@@ -0,0 +1,32 @@
+defmodule Surface.Catalogue.ExtendableSort.Adapters.CategoryFirst do
+  @moduledoc """
+  Sort Module Maps by Module Name in alphabetical order.
+  """
+  @behaviour Surface.Catalogue.ExtendableSort.Adapter
+
+  @impl true
+  def apply(ast) do
+    {:ok, ast |> sort_children |> sort}
+  end
+
+  def sort_children([head | tail] = _ast) do
+    [sort_children(head) | sort_children(tail)]
+  end
+
+  def sort_children(%Surface.Catalogue.ExtendableSort.Category{} = ast) do
+    Map.put(
+      ast,
+      :children,
+      ast.children |> sort_children |> sort
+    )
+  end
+
+  def sort_children(ast) do
+    ast
+  end
+
+  @impl true
+  def sort(ast) do
+    Enum.sort_by(ast, fn p -> p.__struct__ end)
+  end
+end

From a5401b8708166926ed0cd9cb39635876bdd17aae Mon Sep 17 00:00:00 2001
From: Jordan Parker <6415727+byjpr@users.noreply.github.com>
Date: Sat, 23 Apr 2022 17:49:32 +0000
Subject: [PATCH 09/10] Rename for more descriptive module name

---
 .../extendable_sort/adapters/by_catalogue_abc.ex | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)
 create mode 100644 lib/surface/catalogue/extendable_sort/adapters/by_catalogue_abc.ex

diff --git a/lib/surface/catalogue/extendable_sort/adapters/by_catalogue_abc.ex b/lib/surface/catalogue/extendable_sort/adapters/by_catalogue_abc.ex
new file mode 100644
index 0000000..be6e708
--- /dev/null
+++ b/lib/surface/catalogue/extendable_sort/adapters/by_catalogue_abc.ex
@@ -0,0 +1,16 @@
+defmodule Surface.Catalogue.ExtendableSort.Adapters.ByCatalogueABC do
+  @moduledoc """
+  Sort Catalogues in alphabetical order.
+  """
+  @behaviour Surface.Catalogue.ExtendableSort.Adapter
+
+  @impl true
+  def apply(ast) do
+    {:ok, sort(ast)}
+  end
+
+  @impl true
+  def sort(ast) do
+    Enum.sort_by(ast, fn p -> p.name end)
+  end
+end

From 46a12e511e6099101fd963d2f59e5c2523c45bed Mon Sep 17 00:00:00 2001
From: Jordan Parker <6415727+byjpr@users.noreply.github.com>
Date: Sat, 23 Apr 2022 17:49:57 +0000
Subject: [PATCH 10/10] Remove ByCodeDirectory and ByTags

---
 lib/surface/catalogue/extendable_sort.ex | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/lib/surface/catalogue/extendable_sort.ex b/lib/surface/catalogue/extendable_sort.ex
index b4d9261..7cc58db 100644
--- a/lib/surface/catalogue/extendable_sort.ex
+++ b/lib/surface/catalogue/extendable_sort.ex
@@ -9,9 +9,7 @@ defmodule Surface.Catalogue.ExtendableSort do
   def get_sort_config do
     Application.get_env(:surface_catalogue, :sort, [
       Surface.Catalogue.ExtendableSort.Adapters.CategoryFirst,
-      Surface.Catalogue.ExtendableSort.Adapters.ByCodeDirectory,
-      Surface.Catalogue.ExtendableSort.Adapters.ByModuleABC,
-      Surface.Catalogue.ExtendableSort.Adapters.ByTags
+      Surface.Catalogue.ExtendableSort.Adapters.ByCatalogueABC
     ])
   end