keystone_ui 0.33.0 → 0.33.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 599c6b4269b4ca049a5aefe106cb71dc6205554c49fb6e72824f25cc3b6f2597
-  data.tar.gz: 390d82ea8082927248351ba74796fde3a05afe4994b151c79169e0cb190ecacd
+  metadata.gz: af9ebb3caf69815bf6272cf2f67028d1f4e7a98b44f5e8fb0c70654a54b84303
+  data.tar.gz: a0465bf4038d273df4d29aca184443640f113a73260842c7590e12d040557a18
 SHA512:
-  metadata.gz: 2b44fd40afcc3d275dab96ab0401f2748a5555d5e38eb319af16d998454e30f094d9e799603658b0597b7a0e8688a9a8d864aa2e170c3b750d5351a37db123d5
-  data.tar.gz: 65064fb15715bcebbe95efadb89b2a395d06889b6d4962467faeac520df18f88083acd7f5d23ffe8c6057f9434916906861a4c3f02515ae4306cf545bf9eba23
+  metadata.gz: 986eb9e5c25dfafa87579cec226b9a7ec3511478a0a402158e2a5279f290311e3e6d513a2f082f331d01e5f2d0fd73463f7bf108a401276530963a2cecbec977
+  data.tar.gz: 1a0c99faa3fd4c3c03863adf0a467cd53de595367af6cf015c6ffe6afab5e2b31b7713110341b26aad4dd11b6ecd626146020a9aef9549b7c6e600886e383cfa

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

@@ -146,7 +146,7 @@ module Keystone
         saved = KeystoneUi.configuration.supplied_preference(helpers, @key)
         return unless saved
 
-        @hidden_columns = saved[:value]["hidden_columns"]
+        @hidden_columns = saved[:value].to_h.fetch("hidden_columns", @hidden_columns)
         @columns = visible_columns(@hidden_columns)
         @save_url = saved[:save_url]
       end

data/lib/keystone_ui/version.rb

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

data/the_local/agents/keystone_ui-develop.md

@@ -224,12 +224,15 @@ outer element. See Conventions before using it.
   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
+  key that lists `"hidden_columns"`, the hideable columns in that list replace
+  the ones passed in `hidden_columns:`, and a saved empty list shows every
+  column. When the saved value is `nil` or lists no `"hidden_columns"`, the
+  table keeps the columns `hidden_columns:` hides. Whenever the supplier
+  returns a save address, the table renders a "Columns" menu above itself that
+  saves to it, including for a person with nothing saved yet. 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.
+  passed, the table renders from `hidden_columns:` with no Columns menu. In
+  every case `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

data/the_local/agents/keystone_ui-info.md

@@ -127,11 +127,13 @@ holds the catalog.
 - **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.
+  columns to hide, and only columns marked hideable can be hidden. The columns
+  the table's own call hides are its default layout. A saved layout that lists
+  columns to hide replaces that default, and a saved empty list shows every
+  column. When nothing is saved, or the saved layout lists no columns to hide,
+  the table keeps its default. When the supplier gives an address to save to,
+  a "Columns" menu appears above the table and saves the user's choice there,
+  even before anything has been saved.
   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

data/the_local/agents/keystone_ui-install.md

@@ -233,15 +233,23 @@ built on ViewComponent; hook it in before building any screen with those helpers
      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.
+     table's key and returns `{ value:, save_url: }`, or `nil` when the person
+     can neither see nor save a layout 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 and shows no Columns menu.
+   - `value` holds the hidden column names under the string key
+     `"hidden_columns"`, such as `{ "hidden_columns" => ["sku"] }`. That list
+     replaces the hidden columns the table's own call passes, and an empty list
+     shows every column. Only columns marked hideable are hidden.
+   - When `value` is `nil`, or has no `"hidden_columns"` string key, the table
+     keeps the hidden columns its own call passes. A symbol key is not read, so
+     `{ hidden_columns: [...] }` also keeps them.
+   - When nothing is saved yet for a person who may save a layout, return
+     `{ value: nil, save_url: }`. The table then shows its own default layout
+     with the Columns menu, so the person can save a first layout.
+   - When `save_url` is present, the table shows a Columns menu above itself,
+     with the currently hidden columns unchecked.
      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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: keystone_ui
 version: !ruby/object:Gem::Version
-  version: 0.33.0
+  version: 0.33.1
 platform: ruby
 authors:
 - Tyler Schneider