keystone_ui 0.31.0 → 0.33.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a6c7e18e911657e41ed1a4eff2133400015bd7a58e0c437f6886d219173f01fa
-  data.tar.gz: 91b2f652bb7313d9cda361e126e969d06b64827e80118888a73cce3840471f68
+  metadata.gz: 599c6b4269b4ca049a5aefe106cb71dc6205554c49fb6e72824f25cc3b6f2597
+  data.tar.gz: 390d82ea8082927248351ba74796fde3a05afe4994b151c79169e0cb190ecacd
 SHA512:
-  metadata.gz: 466ea8fbb32ed4683db9537a52d7ba41d667f79dfa52aec27aaab85f5fc14b872fcc03b7d880136936133685fdc1af5f839aa4392c5ba698af62694e4a5832b0
-  data.tar.gz: 435630df203142fa669f0d93333e6b2637b2d4ec2d25b6e8fa1a7aa00e54ba5fdace3a3416905c144f706f18373ad78b8b11c067f5d1a62ee6453655358b4b77
+  metadata.gz: 2b44fd40afcc3d275dab96ab0401f2748a5555d5e38eb319af16d998454e30f094d9e799603658b0597b7a0e8688a9a8d864aa2e170c3b750d5351a37db123d5
+  data.tar.gz: 65064fb15715bcebbe95efadb89b2a395d06889b6d4962467faeac520df18f88083acd7f5d23ffe8c6057f9434916906861a4c3f02515ae4306cf545bf9eba23

data/app/components/keystone/ui/data_table_component.html.erb

@@ -1,3 +1,6 @@
+<% if column_picker %>
+  <%= render column_picker %>
+<% end %>
 <div class="<%= Keystone::Ui::DataTableComponent::WRAPPER_CLASSES %>">
   <table class="relative min-w-full divide-y divide-gray-300 dark:divide-white/15">
     <thead class="<%= Keystone::Ui::DataTableComponent::HEAD_CLASSES %>">

data/app/components/keystone/ui/data_table_component.rb

@@ -6,10 +6,10 @@ module Keystone
       EMPTY_CELL_CLASSES = "ks-table-cell-middle text-sm"
       BODY_CLASSES = "ks-table-body"
       HEAD_CLASSES = "ks-table-head"
-      WRAPPER_CLASSES = "ks-table overflow-hidden"
+      WRAPPER_CLASSES = "ks-table overflow-x-auto"
       HEADER_CLASSES_FIRST = "ks-table-header ks-table-header-first text-left text-sm"
       HEADER_CLASSES_MIDDLE = "ks-table-header ks-table-header-middle text-left text-sm"
-      HEADER_CLASSES_LAST = "ks-table-header-last"
+      HEADER_CLASSES_LAST = "ks-table-header ks-table-header-last text-right text-sm"
 
       ROW_CLASSES_FIRST = "ks-table-cell-first text-sm whitespace-nowrap"
       ROW_CLASSES_MIDDLE = "ks-table-cell-middle text-sm whitespace-nowrap"
@@ -26,11 +26,12 @@ module Keystone
       SORT_DESC_ICON = '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 20 20" fill="currentColor"><path fill-rule="evenodd" d="M10 3a.75.75 0 0 1 .75.75v10.638l3.96-4.158a.75.75 0 1 1 1.08 1.04l-5.25 5.5a.75.75 0 0 1-1.08 0l-5.25-5.5a.75.75 0 0 1 1.08-1.04l3.96 4.158V3.75A.75.75 0 0 1 10 3Z" clip-rule="evenodd" /></svg>'
       SORT_NEUTRAL_ICON = '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 20 20" fill="currentColor"><path fill-rule="evenodd" d="M10 3a.75.75 0 0 1 .55.24l3.25 3.5a.75.75 0 1 1-1.1 1.02L10 4.852 7.3 7.76a.75.75 0 0 1-1.1-1.02l3.25-3.5A.75.75 0 0 1 10 3Zm-3.76 9.2a.75.75 0 0 1 1.06.04l2.7 2.908 2.7-2.908a.75.75 0 1 1 1.1 1.02l-3.25 3.5a.75.75 0 0 1-1.1 0l-3.25-3.5a.75.75 0 0 1 .04-1.06Z" clip-rule="evenodd" /></svg>'
 
-      def initialize(items:, columns:, empty_message: nil, sort: nil, sort_direction: nil, sort_url: nil, hidden_columns: [])
+      def initialize(items:, columns:, empty_message: nil, sort: nil, sort_direction: nil, sort_url: nil, hidden_columns: [], key: nil)
         @items = items.to_a
-        all_columns = columns.map { |col| normalize_column(col) }
-        hidden_keys = Array(hidden_columns).map(&:to_sym).to_set
-        @columns = all_columns.reject { |col| col.hideable? && hidden_keys.include?(col.key) }
+        @all_columns = columns.map { |col| normalize_column(col) }
+        @hidden_columns = hidden_columns
+        @columns = visible_columns(hidden_columns)
+        @key = key
         @empty_message = empty_message
         @sort = sort&.to_sym
         @sort_direction = sort_direction&.to_sym
@@ -41,6 +42,7 @@ module Keystone
 
       def before_render
         content
+        apply_saved_layout if @key
       end
 
       def link(column_key, &block)
@@ -55,6 +57,12 @@ module Keystone
         !!@actions_block
       end
 
+      def column_picker
+        return unless @save_url
+
+        @column_picker ||= ColumnPickerComponent.new(columns: @all_columns, hidden_columns: @hidden_columns, save_url: @save_url)
+      end
+
       def column_keys
         @column_keys ||= @columns.map(&:key)
       end
@@ -134,6 +142,20 @@ module Keystone
 
       private
 
+      def apply_saved_layout
+        saved = KeystoneUi.configuration.supplied_preference(helpers, @key)
+        return unless saved
+
+        @hidden_columns = saved[:value]["hidden_columns"]
+        @columns = visible_columns(@hidden_columns)
+        @save_url = saved[:save_url]
+      end
+
+      def visible_columns(hidden_columns)
+        hidden_keys = Array(hidden_columns).map(&:to_sym).to_set
+        @all_columns.reject { |col| col.hideable? && hidden_keys.include?(col.key) }
+      end
+
       def visual_column_count
         @columns.length + (actions? ? 1 : 0)
       end

data/app/components/keystone/ui/figure_component.html.erb

@@ -0,0 +1 @@
+<span class="<%= classes %>"><%= text %></span>

data/app/components/keystone/ui/figure_component.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Keystone
+  module Ui
+    class FigureComponent < ViewComponent::Base
+      TONES = {
+        neutral: nil,
+        success: "ks-tone-success",
+        danger: "ks-tone-danger"
+      }.freeze
+
+      def initialize(text:, tone: :neutral)
+        @text = text
+        @tone = tone
+      end
+
+      attr_reader :text
+
+      def classes
+        [ "ks-figure", TONES.fetch(@tone) ].compact.join(" ")
+      end
+    end
+  end
+end

data/app/components/keystone/ui/info_component.html.erb

@@ -1,4 +1,4 @@
-<span class="inline-flex" data-controller="info" data-action="click@window->info#hide scroll@window->info#close">
+<span class="<%= wrapper_classes %>" data-controller="info" data-action="click@window->info#hide scroll@window->info#close">
   <button type="button" class="<%= button_classes %>" data-info-target="button" data-action="mouseenter->info#peek mouseleave->info#unpeek click->info#toggle" aria-label="More about this"><%= icon.html_safe %></button>
   <span class="<%= summary_classes %>" data-info-target="summary"><%= summary %></span>
   <% if content? %>

data/app/components/keystone/ui/info_component.rb

@@ -14,6 +14,12 @@ module Keystone
 
       attr_reader :summary
 
+      WRAPPER_CLASSES = "inline-flex align-middle"
+
+      def wrapper_classes
+        WRAPPER_CLASSES
+      end
+
       def summary_classes
         SUMMARY_CLASSES
       end

data/app/helpers/keystone_ui_helper.rb

@@ -229,6 +229,10 @@ module KeystoneUiHelper
     render Keystone::Ui::CalculationComponent.new(**args)
   end
 
+  def ui_figure(**args)
+    render Keystone::Ui::FigureComponent.new(**args)
+  end
+
   def ui_info(**args, &block)
     render(Keystone::Ui::InfoComponent.new(**args), &block)
   end

data/lib/keystone_ui/configuration.rb

@@ -2,7 +2,7 @@
 
 module KeystoneUi
   class Configuration
-    attr_accessor :accent, :surface, :theme_mode_supplier, :look_supplier, :trail_supplier
+    attr_accessor :accent, :surface, :theme_mode_supplier, :look_supplier, :trail_supplier, :preference_supplier
     attr_reader :tailwind_imports, :tailwind_sources, :looks, :default_look
 
     def initialize
@@ -33,6 +33,10 @@ module KeystoneUi
     def supplied_trail(view)
       trail_supplier&.call(view)
     end
+
+    def supplied_preference(view, key)
+      preference_supplier&.call(view, key)
+    end
   end
 
   def self.configuration

data/lib/keystone_ui/safelist.rb

@@ -14,6 +14,7 @@ module Keystone
       Keystone::Ui::LineChartComponent,
       Keystone::Ui::CtaBannerComponent,
       Keystone::Ui::FeatureGridComponent,
+      Keystone::Ui::FigureComponent,
       Keystone::Ui::HeroComponent,
       Keystone::Ui::ModalComponent,
       Keystone::Ui::SelectComponent,

data/lib/keystone_ui/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module KeystoneUi
-  VERSION = "0.31.0"
+  VERSION = "0.33.0"
 end

data/the_local/agents/keystone_ui-develop.md

@@ -1,6 +1,6 @@
 ---
 name: keystone_ui-develop
-description: Use PROACTIVELY for building or editing screens in a Rails app that has Keystone UI — pages, forms, tables, navigation, action menus for a record's Edit and Delete, dashboards, charts, marketing sections, a light/dark theme switch — MUST BE USED instead of hand-writing ERB and Tailwind for UI.
+description: Use PROACTIVELY for building or editing screens in a Rails app that has Keystone UI — pages, forms, tables, navigation, action menus for a record's Edit and Delete, dashboards, charts, amounts shown in green or red as a gain or loss, marketing sections, a light/dark theme switch — MUST BE USED instead of hand-writing ERB and Tailwind for UI.
 tools: Read, Write, Edit, Grep
 scope: UI — pages, forms, tables, navigation, dashboards
 ---
@@ -207,19 +207,29 @@ outer element. See Conventions before using it.
 
 ### Tables
 
-- `ui_data_table(items:, columns:, empty_message: nil, sort: nil, sort_direction: nil, sort_url: nil, hidden_columns: [])`
+- `ui_data_table(items:, columns:, empty_message: nil, sort: nil, sort_direction: nil, sort_url: nil, hidden_columns: [], key: nil)`
   — takes a block yielding the table. `items:` are records or hashes; each cell
   value is read by calling the column key on the item, falling back to `item[key]`.
   `columns:` accepts plain `{ key: "Label" }` hashes or `Keystone::Ui::Column`
   objects. In the block, `table.link(:column_key) { |item| url }` turns that
   column's cells into links and `table.actions { |item| ... }` appends a
-  right-aligned actions column. Each row's actions render inside an action
+  right-aligned actions column. With no actions column, the last data
+  column's header and cells are both right-aligned, so put the column of
+  amounts last to line them up under their header. Each row's actions render inside an action
   menu, so the `actions` block holds `ui_action_menu_item` calls and nothing
   else, never buttons or bare links. Sorting requires all three of `sort:` (the
   current column key), `sort_direction:` (`:asc`/`:desc`), and `sort_url:` (a
   lambda taking `(column_key, direction)` and returning a URL); headers then
   render as links that flip direction. `hidden_columns:` drops columns
-  server-side and only affects columns declared `hideable: true`.
+  server-side and only affects columns declared `hideable: true`. `key:` (a
+  symbol or string) names the table so it looks up a saved layout through the
+  app's preference supplier. When the supplier returns a saved value for the
+  key, the hideable columns listed under its `"hidden_columns"` replace the
+  ones passed in `hidden_columns:`, and when it also returns a save address the
+  table renders a "Columns" menu above itself that saves to it. When the
+  supplier returns nothing, when no supplier is set, or when no `key:` is
+  passed, the table renders from `hidden_columns:` with no Columns menu, so
+  `hidden_columns:` is the table's default layout.
 - `Keystone::Ui::Column.new(key, header_text, mobile_hidden: false, sortable: false, hideable: false)`
   — a column with per-column options, for when a `{ key: "Label" }` hash is not
   enough. `mobile_hidden:` hides the column below `sm:`; `sortable:` opts it into
@@ -228,7 +238,9 @@ outer element. See Conventions before using it.
   dropdown of checkboxes for every `hideable` column. Pass it the same columns
   and hidden keys as the table. On toggle it sends `PATCH save_url` with JSON
   `{ "hidden_columns": ["key", ...] }` and a `X-CSRF-Token` header, then reloads
-  the page. The app must provide that endpoint and persist the list.
+  the page. The app must provide that endpoint and persist the list. A table
+  given `key:` renders its own Columns menu when the supplier gives a save
+  address, so never add `ui_column_picker` beside such a table.
 
 ### Content and status
 
@@ -238,6 +250,13 @@ outer element. See Conventions before using it.
   only to the button form.
 - `ui_badge(label:, variant: :neutral, class: nil)` — a pill. `variant:`
   `:neutral` `:success` `:danger` `:warning` `:info`.
+- `ui_figure(text:, tone: :neutral)` — no block. One figure, such as an amount,
+  as inline text with no pill or box around it. `tone:` `:neutral` prints it in
+  the surrounding text colour, `:success` in green and `:danger` in red; any
+  other symbol raises `KeyError`. `text:` is printed as given, so format
+  numbers, currency and any minus sign before passing it. Its output can be
+  passed anywhere a string is shown, such as a `ui_data_table` cell value or
+  column label.
 - `ui_alert(message:, type: :info, title: nil, dismissible: false, class: nil)` —
   a banner.
   `type:` `:info` `:success` `:warning` `:error`. `dismissible: true` adds a
@@ -270,7 +289,8 @@ outer element. See Conventions before using it.
   numbers and currency before passing them. Place it directly under the figure
   it explains, such as a `ui_stat_card`.
 - `ui_info(summary:)` — an info button, named "More about this" for screen
-  readers, placed inline beside the thing it explains. `summary:` is a short
+  readers, placed inline beside the thing it explains, and sits level with the
+  middle of the text beside it. `summary:` is a short
   line of text shown in a floating panel while the button is hovered. The block
   is optional and holds the full detail. With a block, tapping or clicking the
   button toggles a second floating panel holding the block's content, and the
@@ -453,6 +473,13 @@ outer element. See Conventions before using it.
    text with no columns and no separate total, the app's keystone_ui-styles
    version does not define the `ks-breakdown` classes, so stop and hand that
    part to `keystone_ui-install` as well, and add no classes to fix it.
+   To show an amount as a gain or a loss, use `ui_figure` with `tone:` rather
+   than a `ui_badge` or a colour class. Which amounts are coloured, and whether
+   a value counts as a gain or a loss, is the app's own rule, so ask the
+   developer rather than pick. If a figure with `:success` or `:danger` shows in
+   the plain text colour, the app's keystone_ui-styles version does not define
+   the `ks-figure` and `ks-tone-*` classes, so stop and hand that part to
+   `keystone_ui-install`, and add no classes to fix it.
    A field whose value must be one of a fixed list is a `:select` with
    `options:`, and a field that accepts any text and offers common values is a
    text field with `suggestions:`. Which one a field is, and which values it
@@ -485,6 +512,15 @@ outer element. See Conventions before using it.
    objects as soon as one column needs `mobile_hidden:`, `sortable:`, or
    `hideable:`.
 
+   For a table whose hideable columns a user should be able to choose and keep,
+   check whether the app's Keystone UI initializer sets a
+   `preference_supplier`. If it does, pass `key:` and the default
+   `hidden_columns:`, and add no `ui_column_picker`. Which key names the table
+   and which columns it hides by default are the developer's choice, so ask
+   rather than pick. If the app sets no supplier, either use `ui_column_picker`
+   with an endpoint the app owns, as in step 7, or hand setting up a supplier to
+   `keystone_ui-install`, and ask the developer which.
+
 7. Wire up anything that posts back. Several helpers render controls whose
    endpoints the app must own — the column picker's save URL, the pipeline's box
    and link URLs, the swipe deck's outcome events, the modal's open trigger, the

data/the_local/agents/keystone_ui-info.md

@@ -15,7 +15,7 @@ library of view helpers built on ViewComponent. Screens are built from named
 pieces — page shells, sections, panels, grids, form fields, data tables,
 navigation bars, breadcrumbs, cards, stat tiles, charts, funnels, goal buckets, pipelines,
 banners, the calculation behind a figure, a breakdown of amounts and their
-total, an info button — instead of hand-written ERB and
+total, a figure coloured as a gain or a loss, an info button — instead of hand-written ERB and
 Tailwind. Every class the UI renders lives inside the gem, in frozen constants,
 so the look is defined in one place.
 
@@ -47,7 +47,8 @@ shell also uses the page container.
 This local declares no commands. The two working surfaces belong elsewhere:
 
 - **Getting the gem into a host app** — adding it, wiring Tailwind, Stimulus and
-  the theme attributes on the layout, setting the palette → **`keystone_ui-install`**.
+  the theme attributes on the layout, setting the palette, and the suppliers
+  for trails, themes, looks and saved table layouts → **`keystone_ui-install`**.
 - **Building UI with it** — which helper renders what, what keywords it takes,
   how helpers nest → **`keystone_ui-develop`**.
 
@@ -88,7 +89,8 @@ holds the catalog.
   extra text about themselves. Given that text, the piece shows an info button,
   and the text stays hidden until the button is hovered or tapped. A piece
   given no such text shows no button. On a radio card and a checkbox row the
-  button sits on the line with the label.
+  button sits on the line with the label. Wherever it is placed, the button
+  sits level with the text beside it.
 - **Standalone info button.** The same info button can be placed on its own,
   beside anything. It takes a short summary, which is required, and shows it
   when the button is hovered. Given nothing more, a tap shows the summary too.
@@ -113,6 +115,25 @@ holds the catalog.
   of its own, so a breakdown looks right only with a keystone_ui-styles version
   that defines those classes. It has no button and no hidden state of
   its own, and it can be placed inside an info button's detail.
+- **A toned figure is text.** A figure shows one amount inline, in plain text
+  or in the success or danger colour, so it reads as a gain or a loss without a
+  badge around it. The amount is passed as already-formatted text and shown as
+  written, and the tone is chosen by name. An unknown tone raises at render
+  time. The colours come from keystone_ui-styles, so a figure shows its tone
+  only with a keystone_ui-styles version that defines those classes.
+- **The last table column is right-aligned.** In a data table with no actions
+  column, the last column's header is right-aligned like the cells beneath it,
+  so a figure or total placed in that header lines up with the figures below.
+- **Saved table layouts.** A data table can be given a key naming it. A table
+  with a key asks the app, or another gem such as keystone_ui-preferences, for
+  the layout saved under that key for the request. A saved layout lists the
+  columns to hide, and only columns marked hideable can be hidden. When a
+  layout is saved, it replaces the columns the table hides by default. When
+  nothing is saved, the table hides the columns its own call names, so those
+  are its default layout. When the supplier also gives an address to save to,
+  a "Columns" menu appears above the table and saves the user's choice there.
+  A table with no key, or an app with no supplier, renders from its own call
+  alone. Setting up the supplier belongs to the install local.
 - **Suggestions.** A form field can carry a list of suggested values. The
   browser offers them while the field's text is typed, and the user can still
   enter a value that is not on the list. This applies to a field with a typed
@@ -126,7 +147,7 @@ holds the catalog.
   different symbols, and the develop local carries the real values. Most
   components raise on a symbol they do not know, so a wrong guess fails at
   render time.
-- **Figures are numbers.** Components that measure or compare values, such as
+- **Measured values are numbers.** Components that measure or compare values, such as
   progress bars, funnels and buckets, do arithmetic on them. Pass a number, not
   a formatted string such as `"9,000"`. A bucket raises on one.
 - **A funnel has two shapes.** Both size each step against the first step and
@@ -198,5 +219,5 @@ holds the catalog.
   and the theme toggle ship with the gem as Stimulus controllers registered once
   at install. A host writes no JavaScript to use them. Components that post
   somewhere, such as the column picker and the pipeline, post to endpoints the
-  host app owns.
+  host app or another gem owns.
 - Ruby >= 3.2. ViewComponent >= 2.0 and < 5.

data/the_local/agents/keystone_ui-install.md

@@ -1,6 +1,6 @@
 ---
 name: keystone_ui-install
-description: Use to hook Keystone UI into a project — adding the gem, running the install generator to wire Tailwind, the Stimulus controllers and the layout's theme attributes, and configuring the palette, the theme mode supplier, registered looks, the breadcrumb trail supplier and extra Tailwind imports and sources.
+description: Use to hook Keystone UI into a project — adding the gem, running the install generator to wire Tailwind, the Stimulus controllers and the layout's theme attributes, and configuring the palette, the theme mode supplier, registered looks, the breadcrumb trail supplier, the saved table layout supplier and extra Tailwind imports and sources.
 tools: Bash, Read, Edit
 scope: UI — pages, forms, tables, navigation, dashboards
 ---
@@ -26,6 +26,8 @@ built on ViewComponent; hook it in before building any screen with those helpers
   `look_supplier` (which registered look a page gets),
   `trail_supplier` (a callable that supplies the breadcrumb trail for form and
   show pages that pass none, and their Back link when they pass none either),
+  `preference_supplier` (a callable that supplies the saved column layout of a
+  data table given a `key:`, and the address its Columns menu saves to),
   and the `tailwind_imports` and `tailwind_sources` lists (extra CSS files and
   scan paths added to the Tailwind build).
 - `keystone_theme_attributes` — a layout helper placed inside the `<html>` tag.
@@ -40,7 +42,7 @@ built on ViewComponent; hook it in before building any screen with those helpers
 ## How to use it
 
 1. Confirm the prerequisites: Ruby >= 3.2 and **tailwindcss-rails v4+** in the
-   host app. The gem brings ViewComponent and keystone_ui-styles 0.9.0 or later with it.
+   host app. The gem brings ViewComponent and keystone_ui-styles 0.10.0 or later with it.
    Tailwind does not have to be initialized first, because the generator creates
    the stylesheet if it is missing.
 
@@ -153,7 +155,7 @@ built on ViewComponent; hook it in before building any screen with those helpers
    checkbox row, radio card, option card, file upload and colour picker read
    these variables. So do the data display components: stat card, chart card,
    card link, CTA banner, feature grid, hero, data table, code, accordion,
-   disclosure, calculation, info button, breakdown, tab switcher, progress,
+   disclosure, calculation, info button, breakdown, figure, tab switcher, progress,
    funnel, bucket, pipeline and swipe deck.
    So do the navigation components: navbar, nav item, nav dropdown, bottom nav,
    mobile header and settings link. The desktop "Back" link and the breadcrumbs
@@ -179,6 +181,7 @@ built on ViewComponent; hook it in before building any screen with those helpers
      config.default_look = :compact
      config.look_supplier = ->(view) { view.current_user&.look }
      config.trail_supplier = ->(view) { view.breadcrumb_trail }
+     config.preference_supplier = ->(view, key) { TablePreferences.for(view.current_user, key) }
      config.tailwind_imports << "/absolute/path/to/extra.css"
      config.tailwind_sources << "/absolute/path/to/components/**/*.{erb,rb}"
    end
@@ -229,6 +232,24 @@ built on ViewComponent; hook it in before building any screen with those helpers
      writing the callable. If some form or show pages pass no `back_url:`, ask
      where their Back link should come from before enabling the supplier or
      leaving it out.
+   - `preference_supplier` — a callable that receives the view and a data
+     table's key and returns `{ value:, save_url: }`, or `nil` when nothing is
+     saved for that key. It is asked only for tables rendered with a `key:`. A
+     table with no `key:`, a supplier returning `nil`, or no supplier at all
+     renders with the hidden columns its own call passes.
+   - `value` must hold the hidden column names under the string key
+     `"hidden_columns"`, such as `{ "hidden_columns" => ["sku"] }`. A symbol key
+     is not read, and the table then hides no columns. Only columns marked
+     hideable are hidden.
+   - When `save_url` is present, the table shows a Columns menu above itself.
+     Toggling a column sends a `PATCH` to `save_url` with the JSON body
+     `{"hidden_columns": [...]}` and the page's CSRF token, then reloads the
+     page. The host must have a route and action at that address that store the
+     list for that key. With no `save_url`, the saved layout applies and no menu
+     is shown.
+   - A companion preferences gem may set this supplier for the app. Ask the
+     developer whether the app uses one, or which code stores each user's table
+     layouts, before writing the callable.
    - `tailwind_imports` and `tailwind_sources` — lists to append to, never
      assign. Each import becomes an `@import` line and each source becomes an
      `@source` line in `keystone_source.css` on the next boot. They are for

data/the_local/interface.yml

@@ -62,11 +62,13 @@ develop:
   - ui_disclosure
   - ui_calculation
   - ui_info
+  - ui_figure
   - ui_breakdown
   - ui_theme_toggle
   - Keystone::Ui::Column
 
 sources:
+  - app/components/keystone/ui/figure_component.rb
   - lib/generators/keystone/install_generator.rb
   - lib/keystone_ui/configuration.rb
   - lib/keystone_ui/missing_back_link.rb

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: keystone_ui
 version: !ruby/object:Gem::Version
-  version: 0.31.0
+  version: 0.33.0
 platform: ruby
 authors:
 - Tyler Schneider
@@ -125,6 +125,8 @@ files:
 - app/components/keystone/ui/disclosure_component.rb
 - app/components/keystone/ui/feature_grid_component.html.erb
 - app/components/keystone/ui/feature_grid_component.rb
+- app/components/keystone/ui/figure_component.html.erb
+- app/components/keystone/ui/figure_component.rb
 - app/components/keystone/ui/file_upload_component.html.erb
 - app/components/keystone/ui/file_upload_component.rb
 - app/components/keystone/ui/form_component.html.erb