lookbook 0.3.1 → 0.4.0.beta.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e1f01b55ea75634f7e4cf2f7fe438ce6b56042daa5d7f178e50d0db7c267a644
-  data.tar.gz: 81fddb93ab9aed2d51a59ecd00deced19c97a395ced5de3223db0d229f3a57dd
+  metadata.gz: 870ef6a17d84bca0a9fbbc421e27c2d6d682965d96c646f44d3db817e5a5e4f2
+  data.tar.gz: 669ce3b709792be5bdf46ac806efdca269d694349e74f759b0997cbbb456792e
 SHA512:
-  metadata.gz: 535340241df2352ba1c0fa5983f178cdb76d5fc39f0b4c9bcc8c34e4dc782177a4110f85a47ac6632064ac52b064f6936fe9cb764d5a5f2a8b527c9a80342bff
-  data.tar.gz: 1d580f19491db04693d6e31941c198c4b1416665836d90436e84ddf4dadad7e325612be88c959fd2fff1900c061e2e54e2b8cbf82cda5ce947addcdba7bd251d
+  metadata.gz: b0293806f0d57b130c07ae84b5d30fad2625df0cbf2477303d924dddfd42ece6e49b10f15fc0b395fa65adfca3de3ab1096e72565a175bdab14df2af1ba57050
+  data.tar.gz: 2e5ad4ca7957d2684dc367b3a7d89d9922024cfc01cdbcd2567d30b830fe891b815924d64f5b7048783efd42736f41924354255f847850498fd596ba1c25e977

data/README.md

@@ -16,19 +16,17 @@
 
 It uses (and extends) the native [ViewComponent preview functionality](https://viewcomponent.org/guide/previews.html), so you don't need to learn a new DSL or create any extra files to get up and running.
 
-Lookbook uses [RDoc/Yard-style comment tags](https://rubydoc.info/gems/yard/file/docs/Tags.md) to extend the capabilities of ViewComponent's previews whilst maintaining compatability with the standard preview class format, so you can add or remove Lookbook at any time without having to rework your code.
+Lookbook uses [RDoc/Yard-style comment tags](#annotating-preview-files) to extend the capabilities of ViewComponent's previews whilst maintaining compatability with the standard preview class format, so you can add or remove Lookbook at any time without having to rework your code.
 
 ![Lookbook UI](.github/assets/lookbook_screenshot.png)
 
 ### Features
 
-- Tree-style navigation menu
-- Live nav search/filter
+- Tree-style navigation menu with live search/filter
 - Resizable preview window for responsive testing
 - Highlighted preview source code and HTML output
-- Add notes via comments in the preview file (markdown supported)
 - Auto-updating UI when component or preview files are updated _(Rails v6.0+ only)_
-- Hide, group and rename preview examples using comment tags
+- Use comment tag annotations for granular customisation of the preview experience
 - Fully compatible with standard the ViewComponent preview system
 
 ## Lookbook demo
@@ -39,8 +37,6 @@ The [demo app repo](https://github.com/allmarkedup/lookbook-demo) contains instr
 
 ## Installing
 
-> ⚠️ **Please note:** Lookbook is still in the early stages of development and has not yet been well tested across a wide range of Rails/ViewComponent versions and setups. If you run into any problems please [open an issue](issues) with as much detail as possible. Thanks! ⚠️
-
 ### 1. Add as a dependency
 
 Add Lookbook to your `Gemfile` somewhere **after** the ViewComponent gem. For example:
@@ -74,12 +70,13 @@ You don't need to do anything special to see your ViewComponent previews and exa
 
 > If you are new to ViewComponent development, checkout the ViewComponent [documentation](https://viewcomponent.org/guide/) on how to get started developing your components and [creating previews](https://viewcomponent.org/guide/previews.html).
 
-### Annotating preview files
+## Annotating preview files
 
 Lookbook parses [Yard-style comment tags](https://rubydoc.info/gems/yard/file/docs/Tags.md) in your preview classes to customise and extend the standard ViewComponent preview experience:
 
 ```ruby
 # @label Basic Button
+# @display bg_color: "#fff"
 class ButtonComponentPreview < ViewComponent::Preview
 
   # Primary button
@@ -93,11 +90,13 @@ class ButtonComponentPreview < ViewComponent::Preview
     end
   end
 
-  # Secondary button
+  # Inverted button
   # ---------------
-  # This should be used for less important actions.
+  # For light-on-dark screens
+  #
+  # @display bg_color: "#000"
   def secondary
-    render ButtonComponent.new(style: :secondary) do
+    render ButtonComponent.new(style: :inverted) do
       "Click me"
     end
   end
@@ -142,7 +141,12 @@ end
 
 The following Lookbook-specific tags are available for use:
 
-#### `@label <text>`
+* `@label <label>` -[Customise navigation labels](#-label-text)
+* `@hidden` - [Prevent items displaying in the navigation](#-hidden)
+* `@display <key>:<value>` - [Specify params to pass into the preview template](#-display-key-value)
+* `@!group <name> ... @!endgroup` - [Render examples in a group on the same page](#-group-name--endgroup)
+
+### 🔖 `@label <text>`
 
 Used to replace the auto-generated navigation label for the item with `<text>`.
 
@@ -158,7 +162,7 @@ class FooComponentPreview < ViewComponent::Preview
 end
 ```
 
-#### `@hidden`
+### 🔖 `@hidden`
 
 Used to temporarily exclude an item from the Lookbook navigation. The item will still be accessible via it's URL.
 
@@ -176,7 +180,91 @@ class FooComponentPreview < ViewComponent::Preview
 end
 ```
 
-#### `@!group <name> ... @!endgroup`
+### 🔖 `@display <key>: <value>`
+
+The `@display` tag lets you pass custom parameters to your preview layout so that the component preview can be customised on a per-example basis.
+
+```ruby
+# @display bg_color: "#eee"
+class FooComponentPreview < ViewComponent::Preview
+
+  # @display max_width: "500px"
+  # @display wrapper: true
+  def default
+  end
+end
+```
+
+The `@display` tag can be applied at the preview (class) or at the example (method) level, and takes the following format:
+
+```ruby
+# @display <key>: <value>
+```
+
+- `<key>` must be a valid Ruby hash key name, without quotes or spaces
+- `<value>` must be a valid JSON-parsable value. It can be a string (surrounded by **double** quotes), a boolean or an integer.
+
+> [See below for some examples](#some-display-value-examples) of valid and invalid `@display` values.
+
+These display parameters can then be accessed via the `params` hash in your preview layout using `params[:lookbook][:display][<key>]`:
+
+```html
+<!DOCTYPE html>
+<html style="background-color: <%= params[:lookbook][:display][:bg_color] %>">
+  <head>
+    <title>Preview Layout</title>
+  </head>
+  <body>
+    <div style="max-width: <%= params[:lookbook][:display][:max_width] || '100%' %>">
+      <% if params[:lookbook][:display][:wrapper] == true %>
+        <div class="wrapper"><%= yield %></div>
+      <% else %>
+        <%= yield %>
+      <% end %>
+    </div>
+  </body>
+</html>
+```
+
+> By default ViewComponent will use your default application layout for displaying the rendered example. However it's often better to create a seperate layout that you can customise and use specifically for previewing your components. See the  ViewComponent [preview docs](https://viewcomponent.org/guide/previews.html) for instructions on how to set that up.
+
+Any `@display` params set at the preview (class) level with be merged with those set on individual example methods.
+
+#### Global display params
+
+Global (fallback) display params can be defined via a configuration option:
+
+```ruby
+# config/application.rb
+config.lookbook.preview_display_params = {
+  bg_color: "#fff",
+  max_width: "100%"
+}
+```
+
+Globally defined display params will be available to all previews. Any preview or example-level `@display` values with the same name will take precedence and override a globally-set one.
+
+#### Some `@display` value examples:
+
+Valid:
+
+```ruby
+# @display body_classes: "bg-red border border-4 border-green"
+# @display wrap_in_container: true
+# @display emojis_to_show: 4
+# @display page_title: "Special example title"
+```
+
+Invalid:
+
+```ruby
+# @display body_classes: 'bg-red border border-4 border-green' [❌ single quotes]
+# @display wrap_in_container: should_wrap [❌ unquoted string, perhaps trying to call a method]
+# @display page title: "Special example title" [❌ space in key]
+# @display bg_color: #fff [❌ colors need quotes around them, it's not CSS!]
+```
+
+### 🔖 `@!group <name> ... @!endgroup`
 
 For smaller components, it can often make sense to render a set of preview examples in a single window, rather than representing them as individual items in the navigation which can start to look a bit cluttered.
 
@@ -222,7 +310,7 @@ The example above would display the `Sizes` examples grouped together on a singl
 
 You can have as many groups as you like within a single preview class, but each example can only belong to one group.
 
-#### Adding notes
+### Adding notes
 
 All comment text other than tags will be treated as markdown and rendered in the **Notes** panel for that example in the Lookbook UI.
 

data/app/assets/lookbook/js/nav/node.js

@@ -14,6 +14,17 @@ export default function navNode() {
         ? Array.from(this.$refs.items.querySelectorAll(":scope > li"))
         : [];
     },
+    navigateToFirstChild() {
+      if (this.open()) {
+        const child = this.firstVisibleChild();
+        if (child) {
+          const link = child.querySelector(":scope > a.nav-link");
+          if (link) {
+            this.navigate(link.getAttribute("href"));
+          }
+        }
+      }
+    },
     filter() {
       this.hidden = true;
       this.getChildren().forEach((child) => {
@@ -27,5 +38,12 @@ export default function navNode() {
     toggle() {
       this.$store.nav.open[this.id] = !this.$store.nav.open[this.id];
     },
+    firstVisibleChild() {
+      return this.getChildren().find((child) => {
+        return child._x_dataStack
+          ? child._x_dataStack[0].hidden === false
+          : false;
+      });
+    },
   };
 }

data/app/controllers/lookbook/app_controller.rb

@@ -95,14 +95,29 @@ module Lookbook
             html: preview_controller.render_example_to_string(@preview, example.name)
           }
         end
-        joined = render_to_string "./preview_group", locals: {examples: examples}, layout: nil
-        preview_controller.render_in_layout_to_string(joined, @preview.lookbook_layout)
+        set_params
+        joined = render_to_string "lookbook/preview_group", locals: {examples: examples}, layout: nil
+        preview_controller.render_in_layout_to_string(joined, @preview.lookbook_layout || current_layout)
       else
-        preview_controller.request.params[:path] = "#{@preview.preview_name}/#{@example.name}".chomp("/")
+        set_params(@example)
+        preview_controller.params[:path] = "#{@preview.preview_name}/#{@example.name}".chomp("/")
         preview_controller.process(:previews)
       end
     end
 
+    def set_params(example = nil)
+      example_params = @preview.lookbook_display_params.deep_merge(example ? example.lookbook_display_params : {})
+      preview_controller.params.merge!({
+        lookbook: {
+          display: Lookbook.config.preview_display_params.deep_merge(example_params)
+        }
+      })
+    end
+
+    def current_layout
+      preview_controller.send :_layout, preview_controller.lookup_context, [:html]
+    end
+
     def assign_inspector
       @inspector = {
         panes: {
@@ -152,7 +167,7 @@ module Lookbook
     end
 
     def previews
-      Lookbook::Preview.all
+      Lookbook::Preview.all.sort_by(&:label)
     end
 
     def preview_controller

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

@@ -1,5 +1,5 @@
 <div class="flex flex-col h-full min-h-fill w-full">
-  <%= render "./shared/header" %>
+  <%= render "shared/header" %>
   <div class="flex flex-col items-center justify-center h-full min-h-fill">
     <div class="p-4 text-center">
       <svg class="feather w-10 h-10 text-gray-300 mx-auto">
@@ -8,4 +8,4 @@
       <h5 class="mt-4 text-gray-400 text-base">Select a preview to get started</h5>
     </div>
   </div>
-</div>
+</div>

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

@@ -1 +1 @@
-<%= render "./workbench" %>
+<%= render "shared/workbench" %>

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

@@ -10,7 +10,7 @@
 
   <% if config.auto_refresh %>
     <script>
-      window.SOCKET_PATH = "/lookbook/cable";
+      window.SOCKET_PATH = "<%= Lookbook::Engine.websocket_mount_path %>";
     </script>
   <% end %>
   <script src="/lookbook-assets/app.js" defer></script>
@@ -21,14 +21,14 @@
   <div
     x-data="page"
     x-effect="updateTitle"
-    @refresh.document="fetchHTML().then(doc => $dispatch('document:updated', {doc}))" 
+    @refresh.document="fetchHTML().then(doc => $dispatch('document:updated', {doc}))"
     @popstate.window="fetchHTML().then(doc => { $dispatch('document:loaded', {doc}); sidebarOpenMobile = false})"
     @sidebar:toggle.window="sidebarOpenMobile = !sidebarOpenMobile"
     :style="`grid-template-columns: ${$store.nav.width}px 1px 1fr;`"
     class="md:grid w-screen h-screen"
   >
     <div class="h-full bg-gray-100 overflow-hidden" x-show="$screen('md') || sidebarOpenMobile" x-cloak>
-      <%= render "./sidebar" %>
+      <%= render "shared/sidebar" %>
     </div>
     <div x-data="split(splitProps)" class="h-full gutter border-r border-gray-300 relative" x-show="$screen('md')" x-cloak>
       <div class="w-[9px] h-full bg-transparent hover:bg-indigo-100 hover:bg-opacity-20 transition absolute top-0 bottom-0 transform -translate-x-1/2 cursor-[col-resize] z-10"></div>

data/app/views/lookbook/nav/_collection.html.erb

@@ -1,5 +1,5 @@
-<%= render "./nav/node", node: node do %>
+<%= render "nav/node", node: node do %>
   <% node.items.each do |item| %>
-    <%= render "./nav/#{item.type.to_s}", node: item %>
-  <% end %> 
-<% end %>
+    <%= render "nav/#{item.type.to_s}", node: item %>
+  <% end %>
+<% end %>

data/app/views/lookbook/nav/_leaf.html.erb

@@ -5,7 +5,7 @@ label ||= leaf.label
 %>
 <li x-data="navLeaf" :class="{hidden}" x-init="matchers = <%= leaf.matchers.to_json %>; path = '<%= path %>'; setActive()" @popstate.window="setActive">
   <a href="<%= path %>"
-    class="pr-3 py-[5px] flex items-center w-full group transition hover:bg-gray-200 hover:bg-opacity-50"
+    class="nav-link pr-3 py-[5px] flex items-center w-full group transition hover:bg-gray-200 hover:bg-opacity-50"
     style="<%= nav_padding_style(depth) %>"
     :class="{'!bg-indigo-100':active}"
     @click.stop.prevent="navigate"

data/app/views/lookbook/nav/_node.html.erb

@@ -1,5 +1,5 @@
 <li id="<%= node.id %>" x-data="navNode" <% if node.hierarchy_depth == 1 %> class="py-1 border-b border-gray-300 cursor-pointer"<% end %> :class="{hidden}" x-cloak>
-  <div @click="toggle(); if (open()) { <%= "navigate('#{path}')" if defined?(path) %>}" style="<%= nav_padding_style(node.hierarchy_depth) %>" class="hover:bg-gray-200 hover:bg-opacity-50">
+  <div @click="toggle" style="<%= nav_padding_style(node.hierarchy_depth) %>" class="hover:bg-gray-200 hover:bg-opacity-50">
     <div class="flex items-center cursor-pointer pr-3 py-[5px]">
       <svg class="feather w-3 h-3 mr-1 text-gray-500 flex-none">
         <use xlink:href="/lookbook-assets/feather-sprite.svg#chevron-down" x-show="open" x-cloak />
@@ -8,7 +8,7 @@
       <svg class="feather h-3.5 w-3.5 mr-1.5 flex-none text-indigo-500">
         <use xlink:href="/lookbook-assets/feather-sprite.svg#<%= node.type == :preview ? 'layers' : 'folder' %>" />
       </svg>
-      <div class="truncate whitespace-nowrap text-left <%= "font-bold" if node.type == :preview %>">
+      <div class="truncate w-full whitespace-nowrap text-left <%= "font-bold" if node.type == :preview %>" @click.stop="toggle(); navigateToFirstChild();">
         <%= node.label %>
       </div>
     </div>

data/app/views/lookbook/nav/_preview.html.erb

@@ -1,11 +1,11 @@
 <% examples = node.get_examples %>
 <% if examples.many? %>
-  <%= render "./nav/node", node: node, path: show_path(examples.first.path) do %>
+  <%= render "nav/node", node: node, path: show_path(examples.first.path) do %>
     <% examples.each do |example| %>
-      <%= render "./nav/leaf", leaf: example, depth: example.hierarchy_depth + 1 %>
+      <%= render "nav/leaf", leaf: example, depth: example.hierarchy_depth + 1 %>
     <% end %>
   <% end %>
 <% else %>
   <% example = examples.first %>
-  <%= render "./nav/leaf", leaf: example, depth: example.hierarchy_depth, label: node.label, display: :node %>
-<% end %>
+  <%= render "nav/leaf", leaf: example, depth: example.hierarchy_depth, label: node.label, display: :node %>
+<% end %>

data/app/views/lookbook/shared/_header.html.erb

@@ -5,4 +5,4 @@
     </svg>
   </button>
   <%= yield %>
-</header>
+</header>

data/app/views/lookbook/{_sidebar.html.erb → shared/_sidebar.html.erb}

@@ -27,7 +27,7 @@
         <% if @nav.items.any? %>
           <ul x-ref="items">
             <% @nav.items.each do |item| %>
-              <%= render "./nav/#{item.type.to_s}", node: item %>
+              <%= render "nav/#{item.type.to_s}", node: item %>
             <% end %>
           </ul>
           <div class="p-4 text-center" x-show="hidden" x-cloak>
@@ -41,5 +41,5 @@
         <% end %>
       </nav>
     </div>
-  </div>   
-</div>
+  </div>
+</div>

data/app/views/lookbook/{_workbench.html.erb → shared/_workbench.html.erb}

@@ -1,12 +1,12 @@
 <div id="workbench" class="bg-gray-50 h-screen flex flex-col" x-data="workbench">
-  <%= render "./workbench/header" %>
+  <%= render "workbench/header" %>
   <div class="md:grid flex-grow" :style="`grid-template-rows: 1fr 1px ${$store.inspector.height}px`">
-    <%= render "./workbench/preview" %>
+    <%= render "workbench/preview" %>
     <div class="w-full gutter border-t border-gray-300 relative" x-data="split(splitProps)" x-show="$screen('md')">
       <div class="h-[11px] w-full bg-transparent hover:bg-indigo-100 hover:bg-opacity-20 transition absolute left-0 right-0 transform -translate-y-1/2 cursor-[row-resize]"></div>
     </div>
     <% if @inspector %>
-      <%= render "./workbench/inspector", **@inspector %>
+      <%= render "workbench/inspector", **@inspector %>
     <% end %>
-  </div>  
-</div>
+  </div>
+</div>

data/app/views/lookbook/workbench/_header.html.erb

@@ -1,4 +1,4 @@
-<%= render "./shared/header" do %>
+<%= render "shared/header" do %>
   <div class="flex items-center">
     <div class="flex items-center space-x-1">
       <strong class="whitespace-nowrap truncate"><%= @preview.label %></strong>
@@ -36,4 +36,4 @@
       </svg>
     </a>
   </div>
-<% end %>
+<% end %>

data/app/views/lookbook/workbench/_inspector.html.erb

@@ -21,12 +21,12 @@
     <% panes.each do |key, props| %>
       <div class="flex flex-col h-full relative" x-show="active('<%= key %>')" x-cloak>
         <% if props[:clipboard].present? %>
-          <%= render "./shared/clipboard" do %><%= h props[:clipboard].strip %><% end %>
+          <%= render "shared/clipboard" do %><%= h props[:clipboard].strip %><% end %>
         <% end %>
         <div class="flex flex-col h-full overflow-auto">
-          <%= render "./workbench/inspector/#{props[:template]}", key: key, **props %>
+          <%= render "workbench/inspector/#{props[:template]}", key: key, **props %>
         </div>
       </div>
     <% end %>
   </div>
-</div>
+</div>

data/lib/lookbook/collection.rb

@@ -12,11 +12,11 @@ module Lookbook
     end
 
     def name
-      @path ? @path.split("/").last : "root"
+      @path.present? ? @path.split("/").last : "root"
     end
 
     def label
-      name.titleize
+      name&.titleize
     end
 
     def hierarchy_depth
@@ -24,7 +24,7 @@ module Lookbook
     end
 
     def items(sorted = true)
-      sorted ? @items.sort_by(&:name) : @items
+      sorted ? @items.sort_by(&:label) : @items
     end
 
     def add(item)

data/lib/lookbook/engine.rb

@@ -23,12 +23,14 @@ module Lookbook
 
       options.auto_refresh = true if options.auto_refresh.nil?
       options.sort_examples = false if options.sort_examples.nil?
+      options.debug = false unless options.debug == true
 
       options.preview_paths = options.preview_paths.map(&:to_s)
       options.preview_paths += vc_options.preview_paths
 
       options.preview_controller = vc_options.preview_controller if options.preview_controller.nil?
       options.preview_srcdoc = true if options.preview_srcdoc.nil?
+      options.preview_display_params ||= {}
 
       options.listen_paths = options.listen_paths.map(&:to_s)
       options.listen_paths += options.preview_paths
@@ -43,10 +45,6 @@ module Lookbook
       end
     end
 
-    initializer "lookbook.cable.logger" do
-      Lookbook::Engine.cable.logger ||= Rails.logger
-    end
-
     initializer "lookbook.parser.tags" do
       Lookbook::Parser.define_tags
     end
@@ -58,6 +56,15 @@ module Lookbook
       )
     end
 
+    initializer "lookbook.logging" do
+      if config.lookbook.debug == true
+        Lookbook::Engine.cable.logger ||= Rails.logger
+      else
+        Lookbook::Engine.cable.logger = Lookbook::NullLogger.new
+        config.action_view.logger = Lookbook::NullLogger.new
+      end
+    end
+
     initializer "lookbook.preview.extend" do
       ActiveSupport.on_load(:view_component) do
         ViewComponent::Preview.extend Lookbook::Preview
@@ -93,6 +100,10 @@ module Lookbook
         end
       end
 
+      def websocket_mount_path
+        "#{Lookbook::Engine.routes.find_script_name({})}#{cable.mount_path}"
+      end
+
       def cable
         @cable ||= ActionCable::Server::Configuration.new
       end

data/lib/lookbook/null_logger.rb

@@ -0,0 +1,47 @@
+module Lookbook
+  class NullLogger
+    def unknown(*)
+      nil
+    end
+
+    def fatal(*)
+      nil
+    end
+
+    def fatal?
+      false
+    end
+
+    def error(*)
+      nil
+    end
+
+    def error?
+      false
+    end
+
+    def warn(*)
+      nil
+    end
+
+    def warn?
+      false
+    end
+
+    def info(*)
+      nil
+    end
+
+    def info?
+      false
+    end
+
+    def debug(*)
+      nil
+    end
+
+    def debug?
+      false
+    end
+  end
+end

data/lib/lookbook/parser.rb

@@ -5,7 +5,7 @@ module Lookbook
     YARDOC_FILE_PATH = Rails.root.join("tmp/storage/.yardoc").to_s
 
     def initialize(paths)
-      @paths = paths.map { |p| "#{p}/**/*.rb" }
+      @paths = paths.map { |p| "#{p}/**/*_preview.rb" }
       YARD::Registry.yardoc_file = YARDOC_FILE_PATH
     end
 
@@ -27,6 +27,7 @@ module Lookbook
       def define_tags
         YARD::Tags::Library.define_tag("Hidden status", :hidden)
         YARD::Tags::Library.define_tag("Label", :label)
+        YARD::Tags::Library.define_tag("Display", :display)
       end
     end
   end

data/lib/lookbook/preview.rb

@@ -80,7 +80,7 @@ module Lookbook
 
     class << self
       def all
-        ViewComponent::Preview.all
+        ViewComponent::Preview.all.sort_by(&:label)
       end
 
       def find(path)
@@ -90,8 +90,6 @@ module Lookbook
       def exists?(path)
         !!find(path)
       end
-
-      
     end
 
     private

data/lib/lookbook/taggable.rb

@@ -1,23 +1,42 @@
 module Lookbook
   module Taggable
     def lookbook_hidden?
-      if code_object.tag(:hidden)
+      if code_object&.tag(:hidden)
         code_object.tag(:hidden).text.strip != "false"
       end
     end
 
     def lookbook_label
-      code_object.tag(:label)&.text
+      code_object&.tag(:label)&.text
     end
 
     def lookbook_notes
-      code_object.docstring.to_s.strip
+      if code_object&.docstring
+        code_object.docstring.to_s.strip
+      end
     end
 
     def lookbook_group
       code_object&.group
     end
 
+    def lookbook_display_params
+      display_params = {}
+      if code_object&.tags(:display).present?
+        code_object.tags(:display).each do |tag|
+          parts = tag.text.match(/^\s?([^:]*)\s?:\s?(.*)\s?$/)
+          if parts.present?
+            begin
+              display_params[parts[1]] = JSON.parse parts[2]
+            rescue JSON::ParserError => err
+              Rails.logger.error("\n👀 [Lookbook] Invalid JSON in @display tag.\n👀 [Lookbook] (#{err.to_s})\n")
+            end
+          end
+        end
+      end
+      display_params
+    end
+
     # private
 
     def code_object

data/lib/lookbook/version.rb

@@ -1,3 +1,3 @@
 module Lookbook
-  VERSION = "0.3.1"
+  VERSION = "0.4.0.beta.1"
 end

data/lib/lookbook.rb

@@ -12,4 +12,5 @@ module Lookbook
   autoload :PreviewExample, "lookbook/preview_example"
   autoload :PreviewGroup, "lookbook/preview_group"
   autoload :Taggable, "lookbook/taggable"
+  autoload :NullLogger, "lookbook/null_logger"
 end