LoopOS UI v1.1.41.2

Previews

No matching results.

x
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
<div style="display: flex; flex-direction: column; width: 100%;">
  <h1>
    You probably want to use LogList and not the singular Log component.
  </h1>
  <br>
  <div class="lui-log" data-controller="log" data-log-expanded-copy-text-value="Show details" data-log-collapsed-copy-text-value="Hide details">
    <div class="lui-log__main">
      <div class="lui-log__content">
        <div class="lui-log__content__icon">
          <div class="lui-tooltip hidden"
    data-controller="tooltips"
    data-tooltips-tippy-target-id-value=""
    data-tooltips-position-value="top"
    data-tooltips-interactive-value="false"
  >
            <div class="lui-tooltip__title">
              Item
            </div>
          </div>
          <i class="lui-m_icon material-symbols-outlined" style="--lui-micon-size: 20px;">
            package_2
          </i>
        </div>
      
        <div class="lui-log__content__header">
          <div class="lui-log__content__header__title" data-log-target="content">
            <div class="lui-log__word">Log </div>
            <div class="lui-log__word">created </div>
            <div class="lui-log__word">by </div>
            <div class="lui-log__word">Hephaestus</div>
          </div>
        
          <div class="lui-log__content__header__description">
            By 
            Laurence Mosciski
          </div>
                
          <div class="lui-log__buttons">
            <a class="lui-button lui-button--neutral--secondary lui-button--size-tiny w-fit w-fit relative" data-controller="lui--button" data-action="lui--button#startLoading" href="https://loopos-ui-lookbook.lookbook.product-test.stg.loopos.app/rails/active_storage/disk/eyJfcmFpbHMiOnsiZGF0YSI6eyJrZXkiOiJmYWtlX3NjcmlwdF9sb2dfZmlsZV9mb3JfcHJldmlldyIsImRpc3Bvc2l0aW9uIjoiYXR0YWNobWVudDsgZmlsZW5hbWU9XCJmYWtlX3NjcmlwdF9sb2dfZmlsZS50eHRcIjsgZmlsZW5hbWUqPVVURi04JydmYWtlX3NjcmlwdF9sb2dfZmlsZS50eHQiLCJjb250ZW50X3R5cGUiOiJ0ZXh0L3BsYWluIiwic2VydmljZV9uYW1lIjoibG9jYWwifSwiZXhwIjoiMjAyNi0wMy0zMVQxOTo0MzoxMC40MDlaIiwicHVyIjoiYmxvYl9rZXkifX0=--9fc1b22cabe9049df20e215ec49957863f928e71/fake_script_log_file.txt" turbo="false">
              <div class="opacity-100 inline-flex" data-lui--button-target="leadingIcon">
                <div class="flex items-center justify-center" style="width: 12px; height: 12px;"><i class="lui-button__icon lui-button__icon--tiny fa-regular fa-download" data-lui--button-target="leadingIcon"></i></div>
              </div>
  <span class="lui-button__text opacity-100 inline-flex" data-lui--button-target="text">
                Download file
              </span>          
              <div class="absolute w-full flex items-center justify-center opacity-0" data-lui--button-target="loadingIcon">
                <i class="lui-m_icon animate-spin material-symbols-outlined" style="--lui-micon-size: 12px;">
                  progress_activity
                </i>
              </div>
            </a>
            <div class="contents lui-modal-wrapper" data-controller="modal" data-modal-open-value="false" data-modal-single-use-value="false">
              <div class="lui-modal__trigger" data-action="click->modal#open">
                <button class="lui-button lui-button--neutral--secondary lui-button--size-tiny w-fit w-fit relative" data-controller="lui--button">
                  <span class="lui-button__text opacity-100 inline-flex" data-lui--button-target="text">
                    Show details
                  </span>          
                  <div class="absolute w-full flex items-center justify-center opacity-0" data-lui--button-target="loadingIcon">
                    <i class="lui-m_icon animate-spin material-symbols-outlined" style="--lui-micon-size: 12px;">
                      progress_activity
                    </i>
                  </div>
                </button>
              </div>
              <dialog id="" data-modal-target="modal" style="max-width:1080px;" class="lui-modal rounded-md p-0 ">
                <div class="lui-modal__wrapper">
                  <div class="lui-modal__header">
                    <div class="lui-header lui-header--page">
                      <div class="lui-header__title_container">
                        <span class="lui-header__title_container__title">
                          Script log details
                        </span>
                      </div>
  </div>
                    <div class="-mt-1" >
                      <button data-action="click->modal#close" class="cursor-pointer -mr-1 p-1">
                        <div class="lui-icon h-[10px] w-[10px]">
                          <i class="fa-regular fa-xmark lui-icon__icon" style="font-size: 10px; color: black;"></i>
                        </div>
                      </button>
                    </div>
                  </div>
                  <div class="lui-modal__content">
                    <div class="flex flex-col w-full gap-2">
                      <span class="text-[14px]">Parameters</span>
                      -
                    </div>
                    <div class="flex flex-col w-full gap-2">
                      <span class="text-[14px]">Time running</span>
                      -
                    </div>
                    <div class="flex flex-col w-full gap-2">
                      <span class="text-[14px]">Results</span>
                      <turbo-cable-stream-source channel="Turbo::StreamsChannel" signed-stream-name="InNjcmlwdF9sb2dfZGF0YV9wcmV2aWV3LXNjcmlwdC1sb2ci--13c9020db6c00cc295b52d27a91888398631befdf08b004ce999401ae4312b4a"></turbo-cable-stream-source>
                      <div class="flex flex-col w-full h-full gap-2" style="max-height: 35vh;">
                        <div class="text-center text-gray-500 py-8">
                          <p>No results</p>
                        </div>
                      </div>
                    </div>
                  </div>
                </div>
              </dialog>
            </div>
          </div>
        </div>
      </div>
    
      <div class="lui-log__source_content">
        31/03/2026 19:38
      </div>
    </div>
  </div>
</div>

Log

Renders one timeline entry with content, metadata, optional expandable details and action buttons.

Used components Components where it is used
LogList Item logs tab, financial logs modal/list
StateLabel Block/source badge on the right side
Button Expand/download/retry actions

Usage rules

  • ✅ Use log_class + optional block to keep iconography and right badge consistent.
  • ✅ Use from_any_source factories when converting backend payloads.
  • ✅ If passing block, provide full shape { name:, kind:, url: }.
  • ✅ Use with_expand / with_expand_content when you need details; it adds the expand button automatically.
  • ✅ Prefer with_button(...) over with_button_manual(...) unless you need a custom render flow.
  • ❌ Do not pass raw HTML from untrusted sources (prefer factory helpers and controlled content).
1
2
3
4
5
6
7
8
9
<div style="display: flex; flex-direction: column; width: 100%;">
  <h1>
      You probably want to use LogList and not the singular Log component.
  </h1>
  <br>
  <%# log is a ScriptLog instance %>
  <%= render LooposUi::Log.from_any_source(log) %>
</div>

No notes provided.

No params configured.

Description

The Log component is a versatile component for displaying individual log entries with rich content, expandable sections, and interactive elements. It's designed to work within the LogList component but can also be used standalone.

The component supports various content types including text with HTML formatting, entity tokens, expandable content, and action buttons.

Arguments

Property Default Required Description
error false Whether this log represents an error state
user nil User that performed the action (falls back to "System" when blank)
date - ✓ Timestamp of the log entry
log_class "item" Controls left icon (transition, email, sms, item, privacy, etc.)
block nil Optional hash { name:, kind:, url: } rendered as a StateLabel on right

Slots

For content related:

  • content (default slot). Supports rich text with HTML
  • expand - Use via with_expand { ... } or with_expand_content(...); it auto-creates the "Show details" button.
  • button - Use via with_button(...); renders LooposUi::Button.
  • button_manual - Use via with_button_manual { ... } for custom/manual action rendering.
  • source - Populates the right side of the Log. Has polymorphic options:
    • entity_token_source - Renders an EntityToken.
    • source - Alternative interface you can build an entity token and pass in as a parameter.
  • title_token (polymorphic slot) Appears to the left of the log title.
    • Can render:
    • an EntityToken
    • an entity
    • manual content

block hash details

When passing block, use:

{
  name: "Validation",
  kind: "validation", # app/service/block kind
  url: "https://..."  # required when block is provided
}

kind is now mapped to current flow icons, including tool/decision kinds like tag, remove_tag, auto_validation, auto_accept_proposal, decision_*, as well as app kinds (core, submission, hubs, validation, handling).

Factory System

The Log component includes a factory system that allows automatic creation of Log components from various data sources. This system provides a consistent interface for converting different data types into Log components.

How It Works

The factory system automatically detects the appropriate factory for a given data source and uses it to create a Log component. This is done through the from_any_source class method:

log = LooposUi::Log.from_any_source(my_data_source)
# Note you can also use the desired factory directly
log = LooposUi::Log::Factories::CoreItemLogPresenterHash.create(my_data_source)
# or
log = LooposUi::Log::Factories::CoreItemLogPresenterHash.try_create(my_data_source)
# returns NilLog if the factory can't create the log in production
# raises error in development

from_any_source signature:

LooposUi::Log.from_any_source(source)

Implemented Factories

1. CoreItemLogPresenterHash

Purpose: Converts hash data from core item log presenters into Log components.

Data Source: Hash with the following structure:

{
  time: DateTime,
  author: String,
  app_instance: {
    name: String,
    kind: String
  },
  message: String,
  error: Boolean,
  log_class: String,      # optional
  title: String,          # optional
  extra_message: String,  # optional
  block: {                # optional (if present, must include all 3 keys)
    name: String,
    kind: String,
    url: String
  }
}

2. ScriptLog

Purpose: Converts LoopOs::ScriptLog objects into Log components.

Data Source: LoopOs::ScriptLog instances with properties like:

  • created_at
  • user_identification
  • level
  • name
  • files
  • input_data

Automatic Features:

  • Download Button: Automatically added when files are present
  • Retry Button: Automatically added when input_data is present and script is a ScriptProxy with retry capability
  • Info Modal: Always included for detailed script information
  • Retry Modal: Automatically created when retry button is present

Parameters:

  • script: ScriptProxy object that provides retry functionality (optional, for retry button)

Example:

script_proxy = LoopOs::Scripts::ScriptProxy.new(@loop_os_script, context: {
  retry_path_proc: ->(script_log) { 
    rerun_script_script_path(@loop_os_script, script_log_id: script_log.id) 
  }
})
log = LooposUi::Log::Factories::ScriptLog.new(script_log, script: script_proxy).create

Creating Custom Factories

To create a custom factory, you need to:

Inherit from the base class:

class MyCustomFactory < LooposUi::Log::Factories::Base

Implement the can_create? class method:

def self.can_create?(source)
  # Return true if this factory can handle the given source
  source.is_a?(MyCustomModel)
end

Implement the create instance method:

def create
  LooposUi::Log.new(
    date: @source.created_at,
    user: @source.user_name,
    error: @source.error?
  ).with_content(@source.message)
end

Available Instance Variables in create method:

  • @source - The original data source passed to the factory constructor
  • @view_context - Available when using defer_render for complex rendering

Example: Number Factory

Here's a complete example from the dummy app showing how to create a simple factory:

module Factories
  class ExampleLogNumberFactory < LooposUi::Log::Factories::Base
    def self.can_create?(source)
      source.is_a?(Integer)
    end
    def create
      LooposUi::Log.new(
        # random time +- 5days
        date: Time.now + (3*@source).hours + 60.minutes - rand(60).minutes,
        user: "random LogNumberFactory #{@source}",
        error: rand > 0.9
      ).with_content("random message #{@source}")
    end
  end
end

Deferred Rendering

The factory create method must return a LooposUi::Log instance. But this runs before the component is rendered, so if you need to call for render, you need to use defer_render and call the view_context.render method.

def create
  log = LooposUi::Log.new(...)
  log.defer_render do |log, view_context|
    # Complex rendering logic here
    view_context.render( SomeComponent.new(...))
  end
  log
end

You have some helpers methods available if you want to build up the log incrementally:

  • with_expand_content(content)

Note if you want to render HTML directly (e.g from a partial), you need to mark it as html_safe to avoid escaping.

Check for examples in the with_custom_expand example source code.