Implement @location tag

README.md

@@ -248,7 +248,7 @@ The 'todo' list below is intended to provide a _very rough_ overview of the curr
 * [x] `@!group ... @!endgroup`
 * [x] `@id` 🆕
 * [x] `@priority` 🆕
-* [ ] `@logical_path`
+* [x] `@location/@logical_path`
 * [ ] `@component/@renders`
 * [ ] `@source`
 * [ ] `@after_render`

lib/lookbook/config.rb

@@ -128,10 +128,11 @@ def default_preview_tags
         [
           Lookbook::DisplayTag,
           Lookbook::HiddenTag,
+          Lookbook::IdTag,
           Lookbook::LabelTag,
+          Lookbook::LocationTag,
           Lookbook::ParamTag,
-          Lookbook::PriorityTag,
-          Lookbook::IdTag
+          Lookbook::PriorityTag
         ]
       end
 

lib/lookbook/previews/preview_entity.rb

@@ -47,7 +47,13 @@ def url_param
     end
 
     def lookup_path
-      preview_class_name.underscore.downcase.gsub("_component", "").gsub("_preview", "")
+      default_lookup_path = preview_class_name.underscore.downcase.gsub("_component", "").gsub("_preview", "")
+      directory_override = metadata.fetch(:location, metadata.fetch(:logical_path, nil))
+      if directory_override.nil?
+        default_lookup_path
+      else
+        Utils.strip_slashes("#{directory_override}/#{default_lookup_path.split("/").last}")
+      end
     end
 
     def url_path

lib/lookbook/previews/tags/location_tag.rb

@@ -0,0 +1,10 @@
+module Lookbook
+  class LocationTag < YardTag
+    TAG_NAME = "location"
+    TAG_ALIASES = ["logical_path"]
+
+    def value
+      Utils.strip_slashes(@text)
+    end
+  end
+end

lib/lookbook/previews/tags/yard_tag.rb

@@ -13,6 +13,10 @@ def name
       end
 
       def label = name.titleize
+
+      def aliases
+        defined?(self::TAG_ALIASES) ? self::TAG_ALIASES : []
+      end
     end
   end
 end

lib/lookbook/source_parser.rb

@@ -7,6 +7,9 @@ def initialize(log_level: YARD::Logger::ERROR, tags: [])
         tag_class = tag_class.constantize if tag_class.is_a?(String)
 
         YARD::Tags::Library.define_tag(tag_class.label, tag_class.name, tag_class)
+        tag_class.aliases.each do |name|
+          YARD::Tags::Library.define_tag(tag_class.label, name, tag_class)
+        end
       end
     end