lookbook 1.2.1 → 1.3.0

data/app/controllers/lookbook/previews_controller.rb

@@ -1,19 +1,16 @@
 module Lookbook
   class PreviewsController < ApplicationController
-    layout "lookbook/inspector"
+    include TargetableConcern
+    include WithPreviewControllerConcern
 
+    layout "lookbook/inspector"
     helper Lookbook::PreviewHelper
 
     def self.controller_path
       "lookbook/previews"
     end
 
-    before_action :lookup_entities, only: [:preview, :show]
-    before_action :set_title
-    before_action :set_display_options
-    before_action :set_params
-
-    def preview
+    def show
       if @target
         begin
           opts = {layout: @preview.layout}
@@ -31,208 +28,5 @@ module Lookbook
         show_404 layout: "lookbook/standalone"
       end
     end
-
-    def show
-      if @target
-        begin
-          @main_panels = main_panels
-          @drawer_panels = drawer_panels
-        rescue => exception
-          render_in_layout "lookbook/error", layout: "lookbook/inspector", error: prettify_error(exception)
-        end
-      else
-        show_404
-      end
-    end
-
-    def show_legacy
-      Lookbook.logger.warn("Legacy URL path detected. These paths are deprecated and will be removed in a future version")
-      redirect_to lookbook_inspect_path params[:path]
-    end
-
-    private
-
-    def lookup_entities
-      @target = Lookbook.previews.find_example(params[:path])
-      if @target.present?
-        @preview = @target.preview
-        if params[:path] == @preview&.lookup_path
-          redirect_to lookbook_inspect_path "#{params[:path]}/#{@preview.default_example.name}"
-        end
-      else
-        @preview = Lookbook.previews.find(params[:path])
-        if @preview.present?
-          first_example = @preview.examples.first
-          redirect_to lookbook_inspect_path(first_example.lookup_path) if first_example
-        else
-          @preview = Lookbook.previews.find(path_segments.slice(0, path_segments.size - 1).join("/"))
-        end
-      end
-    end
-
-    def show_404(layout: nil)
-      locals = if @preview
-        {
-          message: "Example not found",
-          description: "The '#{@preview.label}' preview does not have an example named '#{path_segments.last}'."
-        }
-      else
-        {
-          message: "Not found",
-          description: "Looked for '#{params[:path]}'.<br>The preview may have been renamed or deleted."
-        }
-      end
-      render_in_layout "lookbook/404", layout: layout, **locals
-    end
-
-    def target_examples
-      @target.type == :group ? @target.examples : [@target]
-    end
-
-    def set_title
-      @title = @target.present? ? [@target&.label, @preview&.label].compact.join(" :: ") : "Not found"
-    end
-
-    def set_display_options
-      @dynamic_display_options = []
-      @static_display_options = []
-
-      if @target.present?
-        opts = @target.display_options
-        @dynamic_display_options = opts.select { _2.is_a?(Array) || _2.is_a?(Hash) }
-        @static_display_options = opts.except(*@dynamic_display_options.keys)
-
-        if params[:_display]
-          display_params = SearchParamParser.call(params[:_display])
-          display_params.each do |name, value|
-            if @dynamic_display_options.key?(name)
-              cookies["lookbook-display-#{name}"] = value
-            end
-          end
-        end
-
-        @dynamic_display_options.each do |name, opts|
-          choices = opts.is_a?(Hash) ? opts[:choices].to_a : opts
-          @static_display_options[name] ||= cookies.fetch("lookbook-display-#{name}", choices.first)
-        end
-
-        unless params[:_display]
-          display_params = @dynamic_display_options.map do |name, opts|
-            [name, @static_display_options[name]]
-          end.to_h
-          request.query_parameters[:_display] = SearchParamBuilder.call(display_params)
-        end
-      end
-    end
-
-    def set_params
-      if @target
-        # cast known params to type
-        @target.params.each do |param|
-          if preview_controller.params.key?(param[:name])
-            preview_controller.params[param[:name]] = Lookbook::Params.cast(preview_controller.params[param[:name]], param[:value_type])
-          end
-        end
-        # set display and data params
-        preview_controller.params.merge!({
-          lookbook: {
-            display: @static_display_options,
-            data: Lookbook.data
-          }
-        })
-      end
-    end
-
-    def preview_params
-      preview_controller.params.permit!
-      preview_controller.params.to_h.select do |key, value|
-        !!@target.params.find { |param| param[:name] == key }
-      end
-    end
-
-    def inspector_data
-      return @inspector_data if @inspector_data.present?
-
-      context_data = {
-        preview_params: preview_params,
-        path: params[:path]
-      }
-
-      preview = @preview
-      examples = target_examples.map do |example|
-        render_args = @preview.render_args(example.name, params: preview_controller.params)
-        has_template = render_args[:template] != "view_components/preview"
-        output = preview_controller.process(:render_example_to_string, @preview, example.name)
-        source = has_template ? example.template_source(render_args[:template]) : example.method_source
-        source_lang = has_template ? example.template_lang(render_args[:template]) : example.lang
-
-        example.define_singleton_method(:output, proc { output })
-        example.define_singleton_method(:source, proc { source })
-        example.define_singleton_method(:source_lang, proc { source_lang })
-        example
-      end
-
-      target = @target.type == :group ? @target : examples.find { |e| e.lookup_path == @target.lookup_path }
-
-      preview.define_singleton_method(:params, proc {
-        target.params
-      })
-
-      @inspector_data ||= Lookbook::Store.new({
-        context: context_data,
-        preview: preview,
-        examples: examples,
-        example: examples.first,
-        target: target,
-        data: Lookbook.data,
-        app: Lookbook
-      })
-    end
-
-    def main_panels
-      Engine.panels.in_group(:main).map do |config|
-        PanelStore.resolve_config(config, inspector_data)
-      end
-    end
-
-    def drawer_panels
-      Engine.panels.in_group(:drawer).map do |config|
-        PanelStore.resolve_config(config, inspector_data)
-      end
-    end
-
-    def preview_controller
-      return @preview_controller if @preview_controller
-      controller = Lookbook::Engine.preview_controller.new
-      controller.request = request
-      controller.response = response
-      @preview_controller ||= controller
-    end
-
-    def prettify_error(exception)
-      error_params = if exception.is_a?(ViewComponent::PreviewTemplateError)
-        {
-          file_path: @preview&.full_path,
-          line_number: 0,
-          source_code: @target&.source
-        }
-      elsif exception.is_a?(ActionView::Template::Error) & exception.message.include?("implements a reserved method")
-        message_parts = exception.message.split("\n").first.split
-        component_class = message_parts.first.constantize
-        naughty_method = message_parts.last.delete("#").delete("`").delete(".")
-        method = component_class.instance_method(naughty_method.to_sym)
-        if method
-          {
-            file_path: method.source_location.first,
-            line_number: method.source_location[1]
-          }
-        end
-      end
-      Lookbook::Error.new(exception, **(error_params || {}))
-    end
-
-    def path_segments
-      params[:path].split("/")
-    end
   end
 end

data/app/helpers/lookbook/output_helper.rb

@@ -1,15 +1,15 @@
 module Lookbook
   module OutputHelper
     def markdown(text = nil, &block)
-      Lookbook::Markdown.render(block ? capture(&block) : text)
+      MarkdownRenderer.call(block ? capture(&block) : text, Lookbook.config.markdown_options)
     end
 
-    def highlight(source, **opts)
-      Lookbook::CodeFormatter.highlight(source, **opts)
+    def highlight(*args, **opts)
+      CodeHighlighter.call(*args, **opts)
     end
 
-    def beautify(source, **opts)
-      Lookbook::CodeFormatter.beautify(source, **opts)
+    def beautify(*args, **opts)
+      CodeBeautifier.call(*args, **opts)
     end
 
     def pretty_json(obj)

data/app/views/layouts/lookbook/skeleton.html.erb

@@ -26,10 +26,10 @@
   <% end %>
 
   <script>
-    window.LOG_LEVEL = <%= Lookbook::Engine.log_level %>;
+    window.LOG_LEVEL = <%= config.log_level %>;
     window.APP_NAME = "<%= Lookbook::Engine.app_name %>";
-    <% if Lookbook::Engine.websocket %>
-    window.SOCKET_PATH = "<%= Lookbook::Engine.websocket_mount_path %>";
+    <% if Lookbook::Engine.websocket.mounted? %>
+    window.SOCKET_PATH = "<%= Lookbook::Engine.websocket.full_mount_path %>";
     <% end %>
   </script>
   

data/app/views/lookbook/index.html.erb

@@ -1,8 +1,19 @@
 <div id="landing" class="flex flex-col items-center justify-center h-full w-full">
   <div class="text-center" id="landing-<%= @previews.any? ? "with" : "no" %>-content">
-    <h5 class="text-base text-lookbook-blank-slate-title truncate uppercase font-black tracking-wider mb-2">
+  <% if config.project_name.downcase == "lookbook" %>
+    <div class="flex justify-center pb-4">
+      <svg class="flex-none mx-auto w-[140px]" viewBox="0 0 275 36">
+        <g fill-rule="nonzero" fill="none">
+          <path d="M4.536 35c-1.408 0-2.504-.392-3.288-1.176-.784-.784-1.176-1.88-1.176-3.288V5.576c0-1.44.384-2.544 1.152-3.312.768-.768 1.856-1.152 3.264-1.152 1.44 0 2.536.384 3.288 1.152.752.768 1.128 1.872 1.128 3.312v22.08h11.712c1.216 0 2.152.312 2.808.936.656.624.984 1.528.984 2.712 0 1.184-.328 2.096-.984 2.736-.656.64-1.592.96-2.808.96H4.536ZM42.066.632c3.425 0 6.425.72 9 2.16 2.577 1.44 4.585 3.464 6.025 6.072 1.44 2.608 2.16 5.672 2.16 9.192 0 2.624-.408 5.008-1.224 7.152-.816 2.144-1.984 3.992-3.504 5.544-1.52 1.552-3.336 2.736-5.448 3.552-2.112.816-4.448 1.224-7.008 1.224-3.424 0-6.432-.728-9.024-2.184-2.592-1.456-4.6-3.496-6.024-6.12-1.424-2.624-2.136-5.68-2.136-9.168 0-2.624.408-5.008 1.224-7.152.816-2.144 1.984-3.984 3.504-5.52 1.52-1.536 3.336-2.712 5.448-3.528C37.17 1.04 39.507.632 42.067.632Zm0 7.392c-1.663 0-3.095.392-4.295 1.176-1.2.784-2.12 1.92-2.76 3.408-.64 1.488-.96 3.304-.96 5.448 0 3.168.704 5.64 2.112 7.416 1.408 1.776 3.376 2.664 5.904 2.664 1.696 0 3.136-.4 4.32-1.2 1.07-.723 1.917-1.733 2.543-3.031-.39-1.314-.934-2.855-2.087-5.286-.07-.147-.07-.233 0-.38l2.187-5.84a8.262 8.262 0 0 0-1.06-1.735c-1.407-1.76-3.375-2.64-5.903-2.64ZM80.27.632c3.424 0 6.424.72 9 2.16 2.576 1.44 4.584 3.464 6.024 6.072 1.44 2.608 2.16 5.672 2.16 9.192 0 2.624-.408 5.008-1.224 7.152-.816 2.144-1.984 3.992-3.504 5.544-1.52 1.552-3.336 2.736-5.448 3.552-2.112.816-4.448 1.224-7.008 1.224-3.424 0-6.432-.728-9.024-2.184-2.592-1.456-4.6-3.496-6.024-6.12-1.424-2.624-2.136-5.68-2.136-9.168 0-2.624.408-5.008 1.224-7.152.816-2.144 1.984-3.984 3.504-5.52 1.52-1.536 3.336-2.712 5.448-3.528C75.373 1.04 77.71.632 80.27.632Zm0 7.392c-1.664 0-3.096.392-4.296 1.176-1.2.784-2.12 1.92-2.76 3.408-.64 1.488-.96 3.304-.96 5.448 0 3.168.704 5.64 2.112 7.416 1.408 1.776 3.376 2.664 5.904 2.664 1.696 0 3.136-.4 4.32-1.2.999-.675 1.804-1.6 2.416-2.775-.395-1.37-.933-2.95-2.162-5.542-.07-.147-.07-.233 0-.38l2.276-6.08a8.166 8.166 0 0 0-.946-1.495c-1.408-1.76-3.376-2.64-5.904-2.64Zm26.299 27.408c-1.408 0-2.496-.392-3.264-1.176-.768-.784-1.152-1.88-1.152-3.288V5.192c0-1.472.384-2.584 1.152-3.336.768-.752 1.856-1.128 3.264-1.128 1.44 0 2.536.376 3.288 1.128.752.752 1.128 1.864 1.128 3.336v10.464h.096l11.664-12.864a7.705 7.705 0 0 1 1.944-1.512c.688-.368 1.464-.552 2.328-.552 1.344 0 2.312.344 2.904 1.032.592.688.864 1.488.816 2.4-.048.912-.424 1.752-1.128 2.52l-11.616 12.336v-3.6l12.192 13.776c.832.928 1.248 1.88 1.248 2.856s-.328 1.784-.984 2.424c-.656.64-1.624.96-2.904.96-1.088 0-1.96-.216-2.616-.648-.656-.432-1.368-1.08-2.136-1.944L111.08 19.736h-.096v11.232c0 1.408-.368 2.504-1.104 3.288-.736.784-1.84 1.176-3.312 1.176Z" fill="#919191"/>
+          <path d="M140.403 35c-1.504 0-2.648-.392-3.432-1.176-.784-.784-1.176-1.912-1.176-3.384V5.72c0-1.472.392-2.6 1.176-3.384.784-.784 1.928-1.176 3.432-1.176h11.712c2.432 0 4.504.36 6.216 1.08 1.712.72 3.016 1.736 3.912 3.048.896 1.312 1.344 2.848 1.344 4.608 0 1.984-.568 3.68-1.704 5.088-1.136 1.408-2.68 2.368-4.632 2.88v-.768c2.304.416 4.088 1.344 5.352 2.784 1.264 1.44 1.896 3.28 1.896 5.52 0 2.976-1.064 5.32-3.192 7.032-2.128 1.712-5.032 2.568-8.712 2.568h-12.192Zm3.84-6.48h7.152c1.632 0 2.824-.312 3.576-.936.752-.624 1.128-1.56 1.128-2.808 0-1.248-.376-2.176-1.128-2.784-.752-.608-1.944-.912-3.576-.912h-7.152v7.44Zm0-13.92h6.288c1.6 0 2.776-.288 3.528-.864.752-.576 1.128-1.456 1.128-2.64 0-1.184-.376-2.056-1.128-2.616-.752-.56-1.928-.84-3.528-.84h-6.288v6.96Zm41.034 20.928c-3.424 0-6.432-.728-9.024-2.184-2.592-1.456-4.6-3.496-6.024-6.12-1.424-2.624-2.136-5.68-2.136-9.168 0-2.624.408-5.008 1.224-7.152.816-2.144 1.984-3.984 3.504-5.52 1.52-1.536 3.336-2.712 5.448-3.528 2.112-.816 4.448-1.224 7.008-1.224 3.424 0 6.424.72 9 2.16 2.576 1.44 4.584 3.464 6.024 6.072 1.44 2.608 2.16 5.672 2.16 9.192 0 2.624-.408 5.008-1.224 7.152-.816 2.144-1.984 3.992-3.504 5.544-1.52 1.552-3.336 2.736-5.448 3.552-2.112.816-4.448 1.224-7.008 1.224Zm0-7.392c1.696 0 3.136-.4 4.32-1.2 1.184-.8 2.096-1.952 2.736-3.456.64-1.504.96-3.312.96-5.424 0-3.168-.704-5.632-2.112-7.392-1.408-1.76-3.376-2.64-5.904-2.64-1.664 0-3.096.392-4.296 1.176-1.2.784-2.12 1.92-2.76 3.408-.64 1.488-.96 3.304-.96 5.448 0 3.168.704 5.64 2.112 7.416 1.408 1.776 3.376 2.664 5.904 2.664Zm38.203 7.392c-3.424 0-6.432-.728-9.024-2.184-2.592-1.456-4.6-3.496-6.024-6.12-1.424-2.624-2.136-5.68-2.136-9.168 0-2.624.408-5.008 1.224-7.152.816-2.144 1.984-3.984 3.504-5.52 1.52-1.536 3.336-2.712 5.448-3.528 2.112-.816 4.448-1.224 7.008-1.224 3.424 0 6.424.72 9 2.16 2.576 1.44 4.584 3.464 6.024 6.072 1.44 2.608 2.16 5.672 2.16 9.192 0 2.624-.408 5.008-1.224 7.152-.816 2.144-1.984 3.992-3.504 5.544-1.52 1.552-3.336 2.736-5.448 3.552-2.112.816-4.448 1.224-7.008 1.224Zm0-7.392c1.696 0 3.136-.4 4.32-1.2 1.184-.8 2.096-1.952 2.736-3.456.64-1.504.96-3.312.96-5.424 0-3.168-.704-5.632-2.112-7.392-1.408-1.76-3.376-2.64-5.904-2.64-1.664 0-3.096.392-4.296 1.176-1.2.784-2.12 1.92-2.76 3.408-.64 1.488-.96 3.304-.96 5.448 0 3.168.704 5.64 2.112 7.416 1.408 1.776 3.376 2.664 5.904 2.664Zm26.299 7.296c-1.408 0-2.496-.392-3.264-1.176-.768-.784-1.152-1.88-1.152-3.288V5.192c0-1.472.384-2.584 1.152-3.336.768-.752 1.856-1.128 3.264-1.128 1.44 0 2.536.376 3.288 1.128.752.752 1.128 1.864 1.128 3.336v10.464h.096l11.664-12.864a7.705 7.705 0 0 1 1.944-1.512c.688-.368 1.464-.552 2.328-.552 1.344 0 2.312.344 2.904 1.032.592.688.864 1.488.816 2.4-.048.912-.424 1.752-1.128 2.52l-11.616 12.336v-3.6l12.192 13.776c.832.928 1.248 1.88 1.248 2.856s-.328 1.784-.984 2.424c-.656.64-1.624.96-2.904.96-1.088 0-1.96-.216-2.616-.648-.656-.432-1.368-1.08-2.136-1.944L254.29 19.736h-.096v11.232c0 1.408-.368 2.504-1.104 3.288-.736.784-1.84 1.176-3.312 1.176Z" fill="#ABABAB"/>
+        </g>
+      </svg>
+    </div>
+  <% elsif config.project_name != false %>
+    <h5 class="text-base text-lookbook-blank-slate-title truncate uppercase font-black tracking-wide mb-2">
       <%= config.project_name %>
     </h5>
+  <% end %>
     <div class="opacity-60">
       <% if @previews.any? %>
         <p>Select a preview from the nav to get started.</p>

data/app/views/lookbook/{previews → inspector}/inputs/_toggle.html.erb

@@ -3,11 +3,11 @@ button_classes = [
   "relative inline-flex flex-shrink-0 h-6 w-11 border-2 border-transparent rounded-full
     cursor-pointer transition-colors ease-in-out duration-200 focus:outline-none focus:ring-2
     focus:ring-offset-2 focus:ring-input-border-focus",
-  value == true ? "bg-lookbook-input-toggle-active" : "bg-lookbook-input-toggle"
+  value == "true" ? "bg-lookbook-input-toggle-active" : "bg-lookbook-input-toggle"
 ]
 span_classes = [
   "pointer-events-none inline-block h-5 w-5 rounded-full bg-white shadow ring-0 transition ease-in-out duration-200",
-  value == true ? "translate-x-5" : "translate-x-0"
+  value == "true" ? "translate-x-5" : "translate-x-0"
 ]
 %>
 
@@ -15,6 +15,6 @@ span_classes = [
   class: class_names(button_classes),
   role: "switch",
   type: "button",
-  "@click.stop": "value = !value" do %>
+  "@click.stop": "value = value == 'true' ? 'false' : 'true'" do %>
   <%= tag.span "aria-hidden": true, class: class_names(span_classes) %>
 <% end %>

data/app/views/lookbook/{previews → inspector}/panels/_params.html.erb

@@ -1,4 +1,4 @@
-<% if preview.params.none? %>
+<% if @params.none? %>
   <div class="p-4 w-full h-full bg-lookbook-prose-bg">
     <%= lookbook_render :prose do %>
       <em class='opacity-50'>No params configured.</em>
@@ -6,9 +6,9 @@
   </div>
 <% else %>
   <div class="h-full overflow-x-hidden">
-    <%= lookbook_render "params/editor", inputs: Lookbook::Engine.inputs do |editor| %>
-      <% preview.params.each do |param| %>
-        <% editor.field **param, value: params[param[:name]] %>
+    <%= lookbook_render "params/editor" do |editor| %>
+      <% @params.each do |param| %>
+        <% editor.field param: param %>
       <% end %>
     <% end %>
   </div>

data/app/views/lookbook/{previews → inspector}/show.html.erb

@@ -1,6 +1,9 @@
 <%= lookbook_render :split_layout,
   alpine_data: "$store.layout.inspector",
-  ":class": "($store.inspector.drawer.hidden || #{@drawer_panels.none?}) && '!grid-rows-[1fr] !grid-cols-[1fr]'" do |layout| %>
+  ":class": "($store.inspector.drawer.hidden || #{@drawer_panels.none?}) && '!grid-rows-[1fr] !grid-cols-[1fr]'",
+  data: {
+    "preview-target": @target.id
+  } do |layout| %>
 
   <%= layout.pane class: "flex flex-col h-full overflow-hidden",
     "x-effect": "forceOrientation = (layoutWidth < $store.inspector.minVerticalSplitWidth) ? 'horizontal' : null" do %>

data/config/app.yml

@@ -2,11 +2,12 @@ shared:
   project_name: Lookbook
   log_level: 2
   log_use_rails_logger: true
-  auto_refresh: true
+  auto_refresh: false
   components_path: app/components
   page_controller: Lookbook::PageController
   page_route: pages
   page_paths: [test/components/docs]
+  page_extensions: [html.*, md.*]
   page_options: {}
   markdown_options:
     tables: true
@@ -33,4 +34,10 @@ shared:
 
 development:
   listen: true
+  auto_refresh: true
+  debug_menu: true
+
+test:
+  listen: false
+  auto_refresh: false
   debug_menu: true

data/config/inputs.yml

@@ -1,48 +1,48 @@
 shared:
   select:
-    partial: lookbook/previews/inputs/select
+    partial: lookbook/inspector/inputs/select
     opts: {}
 
   textarea:
-    partial: lookbook/previews/inputs/textarea
+    partial: lookbook/inspector/inputs/textarea
     opts: {}
 
   toggle:
-    partial: lookbook/previews/inputs/toggle
+    partial: lookbook/inspector/inputs/toggle
     opts: {}
 
   color:
-    partial: lookbook/previews/inputs/color
+    partial: lookbook/inspector/inputs/color
     opts: {}
 
   range:
-    partial: lookbook/previews/inputs/range
+    partial: lookbook/inspector/inputs/range
     opts: {}
 
   text:
-    partial: lookbook/previews/inputs/text
+    partial: lookbook/inspector/inputs/text
     opts: {}
 
   email:
-    partial: lookbook/previews/inputs/text
+    partial: lookbook/inspector/inputs/text
     opts: {}
 
   number:
-    partial: lookbook/previews/inputs/text
+    partial: lookbook/inspector/inputs/text
     opts: {}
 
   tel:
-    partial: lookbook/previews/inputs/text
+    partial: lookbook/inspector/inputs/text
     opts: {}
 
   url:
-    partial: lookbook/previews/inputs/text
+    partial: lookbook/inspector/inputs/text
     opts: {}
 
   date:
-    partial: lookbook/previews/inputs/text
+    partial: lookbook/inspector/inputs/text
     opts: {}
 
   datetime_local:
-    partial: lookbook/previews/inputs/text
+    partial: lookbook/inspector/inputs/text
     opts: {}

data/config/panels.yml

@@ -1,30 +1,30 @@
 shared:
   main:
     - name: preview
-      partial: lookbook/previews/panels/preview
+      partial: lookbook/inspector/panels/preview
       label: Preview
       hotkey: v
 
     - name: output
-      partial: lookbook/previews/panels/output
+      partial: lookbook/inspector/panels/output
       label: HTML
       hotkey: h
 
   drawer:
     - name: source
-      partial: lookbook/previews/panels/source
+      partial: lookbook/inspector/panels/source
       label: Source
       hotkey: s
       copy: "->(data) { data.examples.map { |e| e.source }.join(\n) }"
 
     - name: notes
-      partial: lookbook/previews/panels/notes
+      partial: lookbook/inspector/panels/notes
       label: Notes
       hotkey: n
       disabled: ->(data) { data.examples.select { |e| e.notes.present? }.none? }
 
     - name: params
-      partial: lookbook/previews/panels/params
+      partial: lookbook/inspector/panels/params
       label: Params
       hotkey: p
       disabled: ->(data) { data.preview.params.none? }

data/config/routes.rb

@@ -1,6 +1,6 @@
 Lookbook::Engine.routes.draw do
-  if Lookbook::Engine.websocket?
-    mount Lookbook::Engine.websocket => "/cable", :as => :cable
+  if Lookbook::Engine.websocket.mountable?
+    mount Lookbook::Engine.websocket.server => "/cable", :as => :cable
   end
 
   root to: "application#index", as: :lookbook_home
@@ -8,8 +8,8 @@ Lookbook::Engine.routes.draw do
   get "/#{Lookbook.config.page_route}", to: "pages#index", as: :lookbook_page_index
   get "/#{Lookbook.config.page_route}/*path", to: "pages#show", as: :lookbook_page
 
-  get "/preview/*path", to: "previews#preview", as: :lookbook_preview
-  get "/inspect/*path", to: "previews#show", as: :lookbook_inspect
+  get "/preview/*path", to: "previews#show", as: :lookbook_preview
+  get "/inspect/*path", to: "inspector#show", as: :lookbook_inspect
 
-  get "/*path", to: "previews#show_legacy", as: :lookbook_inspect_legacy
+  get "/*path", to: "inspector#show_legacy", as: :lookbook_inspect_legacy
 end

data/config/tags.yml

@@ -25,5 +25,8 @@ shared:
 
   param:
     label: Param
-    yard_parser: with_name
+    opts: {}
+
+  logical_path:
+    label: Logical Path
     opts: {}