keystone_ui 0.84.0 → 0.86.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/app/components/keystone/ui/badge_component.rb +1 -7
- data/app/components/keystone/ui/states.rb +9 -0
- data/app/components/keystone/ui/status_dot_component.rb +1 -7
- data/app/components/keystone/ui/timeline_component.html.erb +31 -14
- data/app/components/keystone/ui/timeline_component.rb +68 -4
- data/lib/keystone_ui/version.rb +1 -1
- data/the_local/agents/keystone_ui-develop.md +39 -17
- data/the_local/agents/keystone_ui-info.md +16 -6
- data/the_local/agents/keystone_ui-install.md +1 -1
- metadata +2 -1
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: c351ad6abee58f4d2001dab3cf8e299735b69bd2e09651b8c85943c169d17afc
|
|
4
|
+
data.tar.gz: d6f4e92fde93ed1a94a49446c613707a50c2d5cb3d57aac8ee27e06f01a2edeb
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: a327fe7872d4c828217c2dbf33c8b6042a520771708d0b04870b2c627ad00cfa8001bfae481475575c15e156cd5a0697756c2d98fc12236b9a8dfce484c69a1c
|
|
7
|
+
data.tar.gz: c126fda060d77148908eabb68b1d1d2ab538060ff0bc9ad2d80441a2cd09409f2d05aa2221be673fe6fae98a8d790a590fc4fb95fcf94a1d5de20532ff28a5ab
|
|
@@ -3,13 +3,7 @@
|
|
|
3
3
|
module Keystone
|
|
4
4
|
module Ui
|
|
5
5
|
class BadgeComponent < ViewComponent::Base
|
|
6
|
-
VARIANT_CLASSES = {
|
|
7
|
-
neutral: "ks-badge-neutral",
|
|
8
|
-
success: "ks-badge-success",
|
|
9
|
-
danger: "ks-badge-danger",
|
|
10
|
-
warning: "ks-badge-warning",
|
|
11
|
-
info: "ks-badge-info"
|
|
12
|
-
}.freeze
|
|
6
|
+
VARIANT_CLASSES = States::NAMES.to_h { |state| [ state, "ks-badge-#{state}" ] }.freeze
|
|
13
7
|
|
|
14
8
|
attr_reader :label
|
|
15
9
|
|
|
@@ -3,13 +3,7 @@
|
|
|
3
3
|
module Keystone
|
|
4
4
|
module Ui
|
|
5
5
|
class StatusDotComponent < ViewComponent::Base
|
|
6
|
-
STATE_CLASSES = {
|
|
7
|
-
neutral: "ks-status-dot-neutral",
|
|
8
|
-
success: "ks-status-dot-success",
|
|
9
|
-
danger: "ks-status-dot-danger",
|
|
10
|
-
warning: "ks-status-dot-warning",
|
|
11
|
-
info: "ks-status-dot-info"
|
|
12
|
-
}.freeze
|
|
6
|
+
STATE_CLASSES = States::NAMES.to_h { |state| [ state, "ks-status-dot-#{state}" ] }.freeze
|
|
13
7
|
|
|
14
8
|
LABEL_CLASSES = "sr-only"
|
|
15
9
|
|
|
@@ -1,17 +1,24 @@
|
|
|
1
1
|
<% if entries.empty? %>
|
|
2
2
|
<%= render Keystone::Ui::EmptyStateComponent.new(title: "No steps") %>
|
|
3
3
|
<% else %>
|
|
4
|
-
<div class="
|
|
4
|
+
<div class="<%= timeline_classes %>" data-timeline>
|
|
5
|
+
<% if one_line %>
|
|
6
|
+
<div class="<%= ONE_LINE_AXIS_CLASSES %>">
|
|
7
|
+
<% marks.each do |mark| %>
|
|
8
|
+
<span class="<%= MARK_CLASSES %>" data-timeline-mark style="<%= mark[:style] %>"><%= mark[:label] %></span>
|
|
9
|
+
<% end %>
|
|
10
|
+
</div>
|
|
11
|
+
<% end %>
|
|
5
12
|
<% rows.each do |row| %>
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
<div class="<%=
|
|
13
|
+
<% label = content_tag(row_href(row) ? :a : :span, row[:label], class: label_classes, data: { timeline_label: "" }, href: row_href(row)) %>
|
|
14
|
+
<% status = capture do %>
|
|
15
|
+
<span class="<%= status_classes %>">
|
|
16
|
+
<% if running?(row) %><%= render Keystone::Ui::StatusDotComponent.new(state: :info, label: "Running") %><% end %>
|
|
17
|
+
<span data-timeline-duration><%= duration(row) %></span>
|
|
18
|
+
</span>
|
|
19
|
+
<% end %>
|
|
20
|
+
<% track = capture do %>
|
|
21
|
+
<div class="<%= track_classes %>">
|
|
15
22
|
<% row[:tries].each do |entry| %>
|
|
16
23
|
<% if entry[:queued_at] %>
|
|
17
24
|
<div class="<%= QUEUED_CLASSES %>" data-timeline-queued style="<%= queued_style(entry) %>"></div>
|
|
@@ -19,11 +26,21 @@
|
|
|
19
26
|
<%= content_tag(bar_tag(entry), class: bar_classes(entry), data: { timeline_bar: "" }, style: bar_style(entry), href: entry[:href]) do %><% if entry[:href] %><span class="<%= SCREEN_READER_CLASSES %>"><%= entry[:label] %></span> <% end %><% if entry[:failed] %><span class="<%= SCREEN_READER_CLASSES %>">Failed</span><% end %><% end %>
|
|
20
27
|
<% end %>
|
|
21
28
|
</div>
|
|
29
|
+
<% end %>
|
|
30
|
+
<%= tag.div(data: { timeline_row: "" }, class: row_classes(row), aria: { current: ("true" if selected?(row)) }) do %>
|
|
31
|
+
<% if one_line %>
|
|
32
|
+
<%= label %><%= track %><%= status %>
|
|
33
|
+
<% else %>
|
|
34
|
+
<div class="<%= ROW_TEXT_CLASSES %>"><%= label %><%= status %></div>
|
|
35
|
+
<%= track %>
|
|
36
|
+
<% end %>
|
|
37
|
+
<% end %>
|
|
38
|
+
<% end %>
|
|
39
|
+
<% unless one_line %>
|
|
40
|
+
<div class="<%= AXIS_CLASSES %>">
|
|
41
|
+
<span data-timeline-axis-start><%= axis_start_label %></span>
|
|
42
|
+
<span data-timeline-axis-end><%= total_duration %></span>
|
|
22
43
|
</div>
|
|
23
44
|
<% end %>
|
|
24
|
-
<div class="<%= AXIS_CLASSES %>">
|
|
25
|
-
<span data-timeline-axis-start><%= axis_start_label %></span>
|
|
26
|
-
<span data-timeline-axis-end><%= total_duration %></span>
|
|
27
|
-
</div>
|
|
28
45
|
</div>
|
|
29
46
|
<% end %>
|
|
@@ -9,16 +9,39 @@ module Keystone
|
|
|
9
9
|
QUEUED_CLASSES = "ks-timeline-queued absolute inset-y-0"
|
|
10
10
|
SCREEN_READER_CLASSES = "sr-only"
|
|
11
11
|
SELECTED_ROW_CLASSES = "ks-table-row-current"
|
|
12
|
+
TIMELINE_CLASSES = "flex flex-col ks-grid-gap-sm"
|
|
13
|
+
ONE_LINE_TIMELINE_CLASSES = "sm:grid sm:grid-cols-[fit-content(40%)_1fr_auto]"
|
|
14
|
+
ONE_LINE_ROW_CLASSES = "grid grid-cols-[1fr_auto] items-center ks-grid-gap-x-sm text-sm sm:col-span-3 sm:grid-cols-subgrid"
|
|
15
|
+
ONE_LINE_LABEL_CLASSES = "ks-meter-label min-w-0 truncate sm:mb-0"
|
|
16
|
+
ONE_LINE_TRACK_CLASSES = "col-span-2 row-start-2 sm:col-span-1 sm:col-start-2 sm:row-start-1"
|
|
17
|
+
ONE_LINE_STATUS_CLASSES = "ks-meter-label justify-self-end sm:mb-0"
|
|
12
18
|
ROW_TEXT_CLASSES = "ks-meter-label flex justify-between text-sm"
|
|
13
19
|
AXIS_CLASSES = "ks-meter-label flex justify-between text-xs"
|
|
14
20
|
ROW_STATUS_CLASSES = "flex items-center ks-grid-gap-sm"
|
|
21
|
+
ONE_LINE_AXIS_CLASSES = "ks-meter-label relative h-4 text-xs sm:col-start-2"
|
|
22
|
+
MARK_CLASSES = "absolute top-0 whitespace-nowrap"
|
|
15
23
|
MINIMUM_BAR_PERCENT = 2
|
|
24
|
+
MARK_STEPS = [ 1, 2, 5, 10, 15, 30, 60, 120, 300, 600, 900, 1800, 3600, 7200, 10_800, 21_600, 43_200, 86_400 ].freeze
|
|
25
|
+
MAXIMUM_MARK_INTERVALS = 6
|
|
16
26
|
|
|
17
|
-
attr_reader :entries
|
|
27
|
+
attr_reader :entries, :one_line
|
|
18
28
|
|
|
19
|
-
def initialize(entries:)
|
|
29
|
+
def initialize(entries:, one_line: false)
|
|
20
30
|
entries.each { |entry| check_times(entry) }
|
|
21
31
|
@entries = entries
|
|
32
|
+
@one_line = one_line
|
|
33
|
+
end
|
|
34
|
+
|
|
35
|
+
def track_classes
|
|
36
|
+
[ TRACK_CLASSES, (ONE_LINE_TRACK_CLASSES if one_line) ].compact.join(" ")
|
|
37
|
+
end
|
|
38
|
+
|
|
39
|
+
def label_classes
|
|
40
|
+
ONE_LINE_LABEL_CLASSES if one_line
|
|
41
|
+
end
|
|
42
|
+
|
|
43
|
+
def status_classes
|
|
44
|
+
[ ROW_STATUS_CLASSES, (ONE_LINE_STATUS_CLASSES if one_line) ].compact.join(" ")
|
|
22
45
|
end
|
|
23
46
|
|
|
24
47
|
def bar_style(entry)
|
|
@@ -37,6 +60,14 @@ module Keystone
|
|
|
37
60
|
row[:tries].any? { |entry| entry[:selected] }
|
|
38
61
|
end
|
|
39
62
|
|
|
63
|
+
def timeline_classes
|
|
64
|
+
[ TIMELINE_CLASSES, (ONE_LINE_TIMELINE_CLASSES if one_line) ].compact.join(" ")
|
|
65
|
+
end
|
|
66
|
+
|
|
67
|
+
def row_classes(row)
|
|
68
|
+
[ (ONE_LINE_ROW_CLASSES if one_line), (SELECTED_ROW_CLASSES if selected?(row)) ].compact.join(" ").presence
|
|
69
|
+
end
|
|
70
|
+
|
|
40
71
|
def running?(row)
|
|
41
72
|
row[:tries].any? { |entry| entry[:ended_at].nil? }
|
|
42
73
|
end
|
|
@@ -61,6 +92,10 @@ module Keystone
|
|
|
61
92
|
written_duration(axis_end - axis_start)
|
|
62
93
|
end
|
|
63
94
|
|
|
95
|
+
def marks
|
|
96
|
+
(0..mark_intervals).map { |index| { label: written_mark(index * mark_step), style: mark_style(index) } }
|
|
97
|
+
end
|
|
98
|
+
|
|
64
99
|
def axis_start_label
|
|
65
100
|
written_duration(0)
|
|
66
101
|
end
|
|
@@ -80,6 +115,36 @@ module Keystone
|
|
|
80
115
|
parts.map { |amount, unit| "#{amount}#{unit}" }.join(" ")
|
|
81
116
|
end
|
|
82
117
|
|
|
118
|
+
def written_mark(seconds)
|
|
119
|
+
hours, rest = seconds.divmod(3600)
|
|
120
|
+
minutes, seconds = rest.divmod(60)
|
|
121
|
+
parts = [ [ hours, "h" ], [ minutes, "m" ], [ seconds, "s" ] ].reject { |amount, _| amount.zero? }
|
|
122
|
+
parts.empty? ? "0s" : parts.map { |amount, unit| "#{amount}#{unit}" }.join(" ")
|
|
123
|
+
end
|
|
124
|
+
|
|
125
|
+
def mark_style(index)
|
|
126
|
+
return "left: 0%" if index.zero?
|
|
127
|
+
return "right: 0%" if index == mark_intervals
|
|
128
|
+
|
|
129
|
+
"left: #{percent(index * mark_step)}%; transform: translateX(-50%)"
|
|
130
|
+
end
|
|
131
|
+
|
|
132
|
+
def mark_step
|
|
133
|
+
@mark_step ||= MARK_STEPS.find { |step| span <= step * MAXIMUM_MARK_INTERVALS } || (span / (MARK_STEPS.last * MAXIMUM_MARK_INTERVALS)).ceil * MARK_STEPS.last
|
|
134
|
+
end
|
|
135
|
+
|
|
136
|
+
def mark_intervals
|
|
137
|
+
[ (span / mark_step).ceil, 1 ].max
|
|
138
|
+
end
|
|
139
|
+
|
|
140
|
+
def scale
|
|
141
|
+
one_line ? mark_intervals * mark_step : span
|
|
142
|
+
end
|
|
143
|
+
|
|
144
|
+
def span
|
|
145
|
+
axis_end - axis_start
|
|
146
|
+
end
|
|
147
|
+
|
|
83
148
|
def axis_start
|
|
84
149
|
@axis_start ||= entries.map { |entry| entry[:queued_at] || entry[:started_at] }.min
|
|
85
150
|
end
|
|
@@ -101,8 +166,7 @@ module Keystone
|
|
|
101
166
|
end
|
|
102
167
|
|
|
103
168
|
def share(seconds)
|
|
104
|
-
|
|
105
|
-
span.zero? ? 0 : (seconds / span * 100).round(2)
|
|
169
|
+
scale.zero? ? 0 : (seconds.fdiv(scale) * 100).round(2)
|
|
106
170
|
end
|
|
107
171
|
end
|
|
108
172
|
end
|
data/lib/keystone_ui/version.rb
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: keystone_ui-develop
|
|
3
|
-
description: Use PROACTIVELY for building or editing screens in a Rails app that has keystone_ui — page shells with Back links and breadcrumbs, forms and fields, a search field that picks a record or enters a new one, data tables with saved columns, desktop navigation, sidebars and bottom tabs, a page's main action as a phone top-bar icon or a button fixed to the bottom of the screen, a question asked before a button or main action goes ahead, action menus for a record's Edit and Delete, dashboards with stat cards, charts, funnels, goal buckets and timelines of timed steps with retries, queued time, failed tries, steps still running, links to each try and the current step marked, amounts shown in green or red as a gain or loss, status dots coloured by state, pictures held to half the screen, two versions of a text compared line by line side by side, info buttons and breakdowns, marketing sections, a light/dark theme switch — MUST BE USED instead of hand-writing ERB and Tailwind for UI.
|
|
3
|
+
description: Use PROACTIVELY for building or editing screens in a Rails app that has keystone_ui — page shells with Back links and breadcrumbs, forms and fields, a search field that picks a record or enters a new one, data tables with saved columns, desktop navigation, sidebars and bottom tabs, a page's main action as a phone top-bar icon or a button fixed to the bottom of the screen, a question asked before a button or main action goes ahead, action menus for a record's Edit and Delete, dashboards with stat cards, charts, funnels, goal buckets and timelines of timed steps, drawn one line per step with a marked time axis if wanted, with retries, queued time, failed tries, steps still running, links to each try and the current step marked, amounts shown in green or red as a gain or loss, status dots coloured by state, pictures held to half the screen, two versions of a text compared line by line side by side, info buttons and breakdowns, marketing sections, a light/dark theme switch — MUST BE USED instead of hand-writing ERB and Tailwind for UI.
|
|
4
4
|
tools: Bash, Read, Write, Edit, Grep
|
|
5
5
|
scope: UI — pages, forms, tables, navigation, dashboards
|
|
6
6
|
---
|
|
@@ -98,7 +98,7 @@ not available in the app yet, that is `keystone_ui-install`'s job.
|
|
|
98
98
|
- `ui_funnel` — a conversion funnel drawn as bars or one joined shape.
|
|
99
99
|
- `ui_bucket` — an upright container filled toward a goal.
|
|
100
100
|
- `ui_bucket_series` — a wrapping row of buckets.
|
|
101
|
-
- `ui_timeline` — rows of timed steps on one shared time axis, each try of a step a bar on its row, with optional queued time, failed tries and tries still running marked, bars and row labels that open an address, the current row marked, and a "No steps" message when there are no entries.
|
|
101
|
+
- `ui_timeline` — rows of timed steps on one shared time axis, each try of a step a bar on its row, optionally one line per row with a marked axis, with optional queued time, failed tries and tries still running marked, bars and row labels that open an address, the current row marked, and a "No steps" message when there are no entries.
|
|
102
102
|
- `ui_pipeline` — a staged flow diagram with buttons and breakable links that post to the app.
|
|
103
103
|
- `ui_hero` — a marketing hero with title, call-to-action buttons and an aside.
|
|
104
104
|
- `ui_cta_banner` — a marketing banner holding call-to-action buttons.
|
|
@@ -625,13 +625,15 @@ two exceptions: `ui_page`'s `padding:` treats any value other than `:none` as
|
|
|
625
625
|
`full_size_url:`, tapping the picture opens that address in a new tab, so
|
|
626
626
|
pass `src:` a smaller version and `full_size_url:` the original file. Ask
|
|
627
627
|
the developer which version of an uploaded image each address points at.
|
|
628
|
-
- `ui_badge(label:, variant: :neutral, class: nil)` — `variant:` is
|
|
629
|
-
`:neutral` `:success` `:danger` `:warning` `:info
|
|
630
|
-
|
|
631
|
-
|
|
628
|
+
- `ui_badge(label:, variant: :neutral, class: nil)` — `variant:` is one of
|
|
629
|
+
the five states `:neutral` `:success` `:danger` `:warning` `:info`, and
|
|
630
|
+
any other value raises `KeyError` naming it when the badge is drawn.
|
|
631
|
+
- `ui_status_dot(state:, label:)` — `state:` is one of the same five states
|
|
632
|
+
a badge's `variant:` takes, and any other value raises `ArgumentError`
|
|
632
633
|
naming it. `label:` is not shown on screen and is read out by screen
|
|
633
634
|
readers, so pass words that say what the state means. The dot takes the
|
|
634
|
-
colour of a `ui_badge` of the same
|
|
635
|
+
colour of a `ui_badge` of the same state, so a record's state can be
|
|
636
|
+
passed to either one unchanged. Use it where a badge's words
|
|
635
637
|
would crowd the row, such as beside a name in a list, and ask the
|
|
636
638
|
developer which states a record has and what each one means.
|
|
637
639
|
- `ui_alert(message:, type: :info, title: nil, dismissible: false, class: nil)`
|
|
@@ -763,9 +765,10 @@ two exceptions: `ui_page`'s `padding:` treats any value other than `:none` as
|
|
|
763
765
|
the fill turns green with `over: :success` or amber with `over: :warning`.
|
|
764
766
|
- `ui_bucket_series(buckets:)` takes an array of hashes with the keywords
|
|
765
767
|
of `ui_bucket`, such as `[{ goal: 10, actual: 7, label: "Mon" }, ...]`.
|
|
766
|
-
- `ui_timeline(entries:)` takes no block. `entries:` is
|
|
768
|
+
- `ui_timeline(entries:, one_line: false)` takes no block. `entries:` is
|
|
767
769
|
`[{ label:, started_at:, ended_at: nil, queued_at: nil, failed: false, href: nil, selected: false }, ...]`,
|
|
768
|
-
with every time a `Time` value.
|
|
770
|
+
with every time a `Time` value. `one_line:` picks the layout, described
|
|
771
|
+
below.
|
|
769
772
|
- It draws one row per label, in the order each label first appears.
|
|
770
773
|
Entries that share a label, such as the tries of one step, share that
|
|
771
774
|
row and each draws its own bar, so pass a step's tries one after another
|
|
@@ -775,7 +778,8 @@ two exceptions: `ui_page`'s `padding:` treats any value other than `:none` as
|
|
|
775
778
|
`started_at` of any entry to the latest `ended_at`, or to the latest
|
|
776
779
|
`started_at` when that is later.
|
|
777
780
|
- An entry with no `ended_at:`, or `ended_at: nil`, is a try still
|
|
778
|
-
running. Its bar runs to the
|
|
781
|
+
running. Its bar runs to the latest `ended_at` or `started_at` of any
|
|
782
|
+
entry, and its row shows an
|
|
779
783
|
`:info` status dot beside its duration that screen readers read as
|
|
780
784
|
"Running". Leave `ended_at:` out only for a try that has not finished.
|
|
781
785
|
- Every bar is drawn at least 2% of the track wide, so a try that took no
|
|
@@ -797,13 +801,31 @@ two exceptions: `ui_page`'s `padding:` treats any value other than `:none` as
|
|
|
797
801
|
screen readers announce it as the current item. Pass it on the entry the
|
|
798
802
|
page is showing, such as the try whose detail page holds the timeline,
|
|
799
803
|
and on one entry at most.
|
|
800
|
-
- Each row shows its label
|
|
801
|
-
|
|
802
|
-
|
|
803
|
-
|
|
804
|
-
|
|
805
|
-
|
|
806
|
-
|
|
804
|
+
- Each row shows its label, its duration and its track. The row's duration
|
|
805
|
+
runs from its first entry's `started_at` to its last entry's `ended_at`,
|
|
806
|
+
or to the end of the axis when that last entry is still running, so
|
|
807
|
+
queued time before the first try is not counted. Durations are written as
|
|
808
|
+
`1h 0m 5s`, leaving out leading zero units, and a zero duration is `0s`.
|
|
809
|
+
- With the default `one_line: false`, each row shows its label and its
|
|
810
|
+
duration on one line with its track below them, at every width. Under
|
|
811
|
+
the rows the axis reads `0s` on the left and the whole span on the right,
|
|
812
|
+
and the bars fill the track from the start of the axis to its end.
|
|
813
|
+
- With `one_line: true`, from `sm:` up each row is one line: its label,
|
|
814
|
+
then its track, then its duration. The label column is as wide as the
|
|
815
|
+
longest label up to 40% of the timeline, a longer label is cut off with
|
|
816
|
+
an ellipsis, and every row's track has the same width and lines up with
|
|
817
|
+
the others. Below `sm:` each row shows its label and duration on one
|
|
818
|
+
line with its track on a second line across the full width.
|
|
819
|
+
- Above a one-line timeline's first row, in the track column, the axis
|
|
820
|
+
shows marks at even
|
|
821
|
+
intervals from `0s`, at the smallest of 1, 2, 5, 10, 15 or 30 seconds,
|
|
822
|
+
1, 2, 5, 10, 15 or 30 minutes, or 1, 2, 3, 6, 12 or 24 hours that covers
|
|
823
|
+
the whole span in six intervals or fewer, and at whole days past six
|
|
824
|
+
days. The axis ends at the first mark at or after the span, so the
|
|
825
|
+
longest bar can stop short of the right edge, and every bar and mark is
|
|
826
|
+
placed on that axis. A mark is written with each non-zero unit, such as
|
|
827
|
+
`1m 30s` or `1h 5s`.
|
|
828
|
+
- Ask the developer which layout a screen uses.
|
|
807
829
|
- An entry with no `started_at:` raises `ArgumentError` naming its label,
|
|
808
830
|
and so does an entry whose `ended_at:` is before its `started_at:`. Check
|
|
809
831
|
the times before rendering rather than rescuing the error.
|
|
@@ -77,7 +77,15 @@ One decision: is keystone_ui set up in the app?
|
|
|
77
77
|
as "Running". Every bar is drawn at least a small visible width, so a try
|
|
78
78
|
that took no time still shows. An entry with no start time, or one that ends
|
|
79
79
|
before it starts, raises `ArgumentError` naming its label. A timeline with no
|
|
80
|
-
entries shows a message saying there are no steps.
|
|
80
|
+
entries shows a message saying there are no steps. By default each row shows
|
|
81
|
+
its label and duration on one line with the bar below, and the axis under the
|
|
82
|
+
rows shows only `0s` and the total duration. A timeline can be drawn one line
|
|
83
|
+
per row instead: from `sm:` up each row holds its label, its bar and its
|
|
84
|
+
duration side by side, every row's bar has the same width, and a long label is
|
|
85
|
+
cut off with an ellipsis. Below `sm:` the bar moves under the label and
|
|
86
|
+
duration. In that layout the axis, drawn above the first row, shows marks at the smallest round time step
|
|
87
|
+
that covers the run in six intervals or fewer, and the axis ends at the last mark rather than at the latest
|
|
88
|
+
time, so bars are placed against that longer axis. An entry can carry an address, and then its bar is a link to it whose
|
|
81
89
|
name screen readers announce is the entry's label, and the row's label links
|
|
82
90
|
to the address of the last entry in that row that has one. An entry can be
|
|
83
91
|
marked selected, and the row holding it is drawn in the same tint as a data
|
|
@@ -130,11 +138,13 @@ One decision: is keystone_ui set up in the app?
|
|
|
130
138
|
- **Action menus.** Each action is a label, an address and an HTTP method. A
|
|
131
139
|
plain visit is a link, and any other method is a button, so an action that
|
|
132
140
|
changes data is never a bare link. A delete asks for confirmation by default.
|
|
133
|
-
- **Status states.** A badge and a status dot
|
|
134
|
-
success, danger, warning and info. A
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
141
|
+
- **Status states.** A badge and a status dot read one list of five states:
|
|
142
|
+
neutral, success, danger, warning and info. A state added to that list is
|
|
143
|
+
accepted by both, so the two never disagree about which states exist. A badge
|
|
144
|
+
shows its label as text. A status dot shows only its state's colour, for
|
|
145
|
+
places with no room for text, and its label is read only by screen readers.
|
|
146
|
+
Neither accepts a state outside the list: a status dot raises `ArgumentError`
|
|
147
|
+
naming the states it expects, and a badge raises `KeyError` when it renders.
|
|
138
148
|
- **Text diffs.** A text diff compares two texts line by line and shows them
|
|
139
149
|
side by side, stacked on a phone, in the code block's look. Lines the two
|
|
140
150
|
share sit on the same row, a line only the first text has is marked removed
|
|
@@ -162,7 +162,7 @@ built on ViewComponent; hook it in before building any screen with those helpers
|
|
|
162
162
|
@import "./look.css";
|
|
163
163
|
```
|
|
164
164
|
|
|
165
|
-
Buttons, panels, cards, alerts, badges, form fields, the modal, the mobile
|
|
165
|
+
Buttons, panels, cards, alerts, badges, status dots, form fields, the modal, the mobile
|
|
166
166
|
action menu, the action menu, the column picker, multi select, search select, copy button, theme toggle,
|
|
167
167
|
checkbox row, radio card, option card, file upload and colour picker read
|
|
168
168
|
these variables. So do the data display components: stat card, chart card,
|
metadata
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
|
2
2
|
name: keystone_ui
|
|
3
3
|
version: !ruby/object:Gem::Version
|
|
4
|
-
version: 0.
|
|
4
|
+
version: 0.86.0
|
|
5
5
|
platform: ruby
|
|
6
6
|
authors:
|
|
7
7
|
- Tyler Schneider
|
|
@@ -214,6 +214,7 @@ files:
|
|
|
214
214
|
- app/components/keystone/ui/sortable_list_component.rb
|
|
215
215
|
- app/components/keystone/ui/stat_card_component.html.erb
|
|
216
216
|
- app/components/keystone/ui/stat_card_component.rb
|
|
217
|
+
- app/components/keystone/ui/states.rb
|
|
217
218
|
- app/components/keystone/ui/status_dot_component.rb
|
|
218
219
|
- app/components/keystone/ui/swipe_deck_component.html.erb
|
|
219
220
|
- app/components/keystone/ui/swipe_deck_component.rb
|