Class: Lookbook::Engine

Inherits:
Rails::Engine
  • Object
show all
Defined in:
lib/lookbook/engine.rb

Class Method Summary collapse

Instance Method Summary collapse

Class Method Details

.auto_refresh? ⇒ Boolean

Returns:

  • (Boolean) 


108
109
110
111
112
113
 
# File 'lib/lookbook/engine.rb', line 108

def auto_refresh?
  opts.live_updates == true &&
    reloading? &&
    runtime_context.web? &&
    FileWatcher.evented?
end

.component_paths ⇒ Object 



171
172
173
174
175
176
 
# File 'lib/lookbook/engine.rb', line 171

def component_paths
  @_component_paths ||= begin
    paths = [*opts.component_paths, *view_paths, host_app_path]
    PathUtils.normalize_paths(paths)
  end
end

.files_changed(modified, added, removed) ⇒ Object 



232
233
234
235
236
 
# File 'lib/lookbook/engine.rb', line 232

def files_changed(modified, added, removed)
  changes = {modified: modified, added: added, removed: removed}
  reloaders.register_changes(changes)
  notify_clients(changes)
end

.hooks ⇒ Object 



143
144
145
 
# File 'lib/lookbook/engine.rb', line 143

def hooks
  @_hooks ||= HookStore.new
end

.host_app_path ⇒ Object 



153
154
155
 
# File 'lib/lookbook/engine.rb', line 153

def host_app_path
  Rails.application.root.join("app")
end

.host_config ⇒ Object 



157
158
159
 
# File 'lib/lookbook/engine.rb', line 157

def host_config
  Rails.application.config
end

.inputs ⇒ Object 



135
136
137
 
# File 'lib/lookbook/engine.rb', line 135

def inputs
  @_inputs ||= InputStore.init_from_config
end

.load_pages(changes = nil) ⇒ Object 



218
219
220
221
222
223
 
# File 'lib/lookbook/engine.rb', line 218

def load_pages(changes = nil)
  pages.load(Engine.page_paths, changes)
rescue => e
  Lookbook.logger.error(e)
  raise e
end

.load_previews(changes = nil) ⇒ Object 



208
209
210
211
212
213
214
215
216
 
# File 'lib/lookbook/engine.rb', line 208

def load_previews(changes = nil)
  changed_files = [*changes[:added], *changes[:modified]] if changes
  parser.parse(changed_files) do |code_objects|
    previews.load(code_objects.all(:class), changes)
  end
rescue => e
  Lookbook.logger.error(e)
  raise e
end

.mount_path ⇒ Object 



96
97
98
 
# File 'lib/lookbook/engine.rb', line 96

def mount_path
  routes.find_script_name({})
end

.mounted? ⇒ Boolean

Returns:

  • (Boolean) 


100
101
102
 
# File 'lib/lookbook/engine.rb', line 100

def mounted?
  mount_path.present?
end

.notify_clients(changes = nil) ⇒ Object 



225
226
227
228
229
230
 
# File 'lib/lookbook/engine.rb', line 225

def notify_clients(changes = nil)
  return unless changes.present?

  websocket.broadcast(:reload)
  run_hooks(:after_change, changes.to_h)
end

.page_paths ⇒ Object Also known as: page_watch_paths 



178
179
180
 
# File 'lib/lookbook/engine.rb', line 178

def page_paths
  @_page_paths ||= PathUtils.normalize_paths(opts.page_paths)
end

.pages ⇒ Object 



195
196
197
 
# File 'lib/lookbook/engine.rb', line 195

def pages
  @_pages ||= PageCollection.new
end

.panels ⇒ Object 



131
132
133
 
# File 'lib/lookbook/engine.rb', line 131

def panels
  @_panels ||= PanelStore.init_from_config
end

.preview_controller ⇒ Object 



203
204
205
206
 
# File 'lib/lookbook/engine.rb', line 203

def preview_controller
  @_preview_controller = opts.preview_controller.constantize
  @_preview_controller.include PreviewControllerActions
end

.preview_embeds_allowed? ⇒ Boolean

Returns:

  • (Boolean) 


115
116
117
 
# File 'lib/lookbook/engine.rb', line 115

def preview_embeds_allowed?
  opts.preview_embeds.enabled == true && opts.preview_embeds.policy != "DENY"
end

.preview_paths ⇒ Object 



184
185
186
 
# File 'lib/lookbook/engine.rb', line 184

def preview_paths
  @_preview_paths ||= PathUtils.normalize_paths(opts.preview_paths)
end

.preview_watch_paths ⇒ Object 



188
189
190
191
192
193
 
# File 'lib/lookbook/engine.rb', line 188

def preview_watch_paths
  @_preview_watch_paths ||= begin
    paths = [*opts.preview_paths, *opts.component_paths, *opts.listen_paths, *view_paths].uniq
    PathUtils.normalize_paths(paths)
  end
end

.previews ⇒ Object 



199
200
201
 
# File 'lib/lookbook/engine.rb', line 199

def previews
  @_previews ||= PreviewCollection.new
end

.reloading? ⇒ Boolean

Returns:

  • (Boolean) 


104
105
106
 
# File 'lib/lookbook/engine.rb', line 104

def reloading?
  opts.reload_on_change
end

.run_hooks(event_name, *args) ⇒ Object 



147
148
149
150
151
 
# File 'lib/lookbook/engine.rb', line 147

def run_hooks(event_name, *args)
  hooks.for_event(event_name).each do |hook|
    hook.call(Lookbook, *args)
  end
end

.runtime_context ⇒ Object 



123
124
125
 
# File 'lib/lookbook/engine.rb', line 123

def runtime_context
  @_runtime_context ||= RuntimeContext.new(env: Rails.env)
end

.tags ⇒ Object 



139
140
141
 
# File 'lib/lookbook/engine.rb', line 139

def tags
  @_tags ||= TagStore.init_from_config
end

.theme ⇒ Object 



127
128
129
 
# File 'lib/lookbook/engine.rb', line 127

def theme
  @_theme ||= Lookbook::Theme.new(opts.ui_theme, opts.ui_theme_overrides)
end

.view_paths ⇒ Object 



161
162
163
164
165
166
167
168
169
 
# File 'lib/lookbook/engine.rb', line 161

def view_paths
  # handle view path registry changes in Rails 7.1
  paths = if defined?(ActionView::PathRegistry)
    ActionView::PathRegistry.all_file_system_resolvers.map(&:path)
  else
    ActionView::ViewPaths.all_view_paths.flat_map(&paths)
  end
  paths.map { |path| Pathname(path.to_s) }
end

.websocket ⇒ Object 



119
120
121
 
# File 'lib/lookbook/engine.rb', line 119

def websocket
  @_websocket ||= auto_refresh? ? Websocket.new(mount_path, logger: Lookbook.logger) : NullWebsocket.new
end

Instance Method Details

#opts ⇒ Object 



81
82
83
 
# File 'lib/lookbook/engine.rb', line 81

def opts
  Lookbook.config
end

#parser ⇒ Object 



85
86
87
 
# File 'lib/lookbook/engine.rb', line 85

def parser
  @_parser ||= PreviewParser.new(opts.preview_paths, Engine.tags)
end

#reloaders ⇒ Object 



89
90
91
 
# File 'lib/lookbook/engine.rb', line 89

def reloaders
  @_reloaders ||= Reloaders.new
end