keystone_ui 0.25.0 → 0.26.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0dcc3e30b080deb833cdbbcde6a946930de28fa541cb24fbdef2d83087eaca7c
-  data.tar.gz: 4c623f38dcbdd1f43371359af97b06fafd59796570267479db951236ac7daf85
+  metadata.gz: c9326e16fe4c64a14c5887cd37a4dee97f6a5683572c5170312f9696f0826b1f
+  data.tar.gz: 1f4b15310af0f3fd7ef1523137eb7f35b7697cddf64a3d0326259ae2d3b480c0
 SHA512:
-  metadata.gz: 38add779239157bad1402f79b96cd66bf3219c39dac2e90b8d3b27eda892137bc1b2b5a0f5ed5df175e92b3963a90996fbc861d81b82667f87f711b37e08b7af
-  data.tar.gz: 4838c78a35737a4bdea3d3d847ddc7b60276a9630543990510a9ef0c2e67a52a34d0b87cf939b4d14a8213a9a0d52fe528615e232626c8b84de24d89158bc79f
+  metadata.gz: b8d0630ea4fc5547a6f1644fcb73b61630189baae97fe6b2525847b5a8858a28b7db0bcc5d841f4c03541d3f985e99a8eb07f0fe3330ffa6450c90e1d9680081
+  data.tar.gz: e26a899b093a8f678c60b43dfe6a8e3d92a2d52c0f38accd1b3421649d99ed36800ad9c3c2a201ba4857c069d5af1c66afb094ad05c182cacfa5cf590fb80546

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

@@ -5,16 +5,23 @@ module Keystone
     class ActionMenuItemComponent < ViewComponent::Base
       ITEM_CLASSES = "ks-menu-option block w-full text-left"
 
-      def initialize(label:, href:, method: :get)
+      def initialize(label:, href:, method: :get, confirm: nil)
         @label = label
         @href = href
         @method = method.to_sym
+        @confirm = confirm
+      end
+
+      def question
+        return @confirm if @confirm
+
+        "#{@label} this? This cannot be undone." if @method == :delete
       end
 
       def call
         return link_to(@label, @href, class: ITEM_CLASSES) if @method == :get
 
-        button_to(@href, method: @method, class: ITEM_CLASSES) { @label }
+        button_to(@href, method: @method, class: ITEM_CLASSES, form: { data: { turbo_confirm: question }.compact }) { @label }
       end
     end
   end

data/lib/keystone_ui/version.rb

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

data/the_local/agents/keystone_ui-develop.md

@@ -120,12 +120,15 @@ outer element. See Conventions before using it.
 - `ui_action_menu` — no keywords, takes a block. An ellipsis (⋯) button that
   opens a dropdown of actions, shown at every screen size. Fill the block with
   `ui_action_menu_item` calls.
-- `ui_action_menu_item(label:, href:, method: :get)` — one entry in an action
-  menu. With `method: :get` it is a link to `href`. Any other method, such as
-  `:post`, `:patch` or `:delete`, renders a button inside its own small form
-  that sends that method to `href`, so never place such an item inside a
-  `ui_form` block, since a form cannot contain another form. It asks for no
-  confirmation before sending.
+- `ui_action_menu_item(label:, href:, method: :get, confirm: nil)` — one entry
+  in an action menu. With `method: :get` it is a link to `href`. Any other
+  method, such as `:post`, `:patch` or `:delete`, renders a button inside its
+  own small form that sends that method to `href`, so never place such an item
+  inside a `ui_form` block, since a form cannot contain another form.
+  `confirm:` is a question Turbo asks before the item sends. With no
+  `confirm:`, a `method: :delete` item asks "<label> this? This cannot be
+  undone.", and every other method sends without asking. A `method: :get` item
+  is a plain link and ignores `confirm:`.
 - `ui_mobile_actions` — no keywords, takes a block. An ellipsis dropdown for
   mobile actions; the block holds the menu items. Hidden above `lg:`. Use
   `ui_action_menu` instead when the actions must also be reachable on desktop.
@@ -381,9 +384,10 @@ outer element. See Conventions before using it.
    Put the actions on a record, such as Edit and Delete, in an action menu
    rather than in a row of buttons: `menu:` on the `ui_section` that shows the
    record, `table.actions` for a table row, or `ui_action_menu` anywhere else.
-   An item that deletes or changes data sends without asking for
-   confirmation, so ask the developer whether that action needs a confirmation
-   step before adding it.
+   A delete item asks for confirmation on its own, so pass `confirm:` only
+   when the developer wants different wording. A `:post`, `:patch` or `:put`
+   item sends without asking, so ask the developer whether that action needs
+   a question, and pass it as `confirm:` if it does.
 
 6. For a table, decide how columns are declared. Use `{ key: "Label" }` hashes
    when every column is plain. Switch the whole set to `Keystone::Ui::Column`

data/the_local/agents/keystone_ui-info.md

@@ -78,8 +78,10 @@ holds the catalog.
   of actions, shown at every screen size. The mobile action menu is the one
   hidden from `lg:` up. Each action is a label, an address and an HTTP method.
   A plain visit renders as a link. Any other method renders as a button that
-  sends that method, so an action that changes data is never a bare link. A
-  data table puts each row's actions in one action menu at the end of the row,
+  sends that method, so an action that changes data is never a bare link. An
+  action can carry a question that Turbo asks before it runs. A delete asks
+  "<label> this? This cannot be undone." unless it is given its own question,
+  and other actions ask nothing unless given one. A data table puts each row's actions in one action menu at the end of the row,
   and a section can carry an action menu in its header beside its title.
 - **Options are symbols, and each component accepts its own set.** Appearance is
   chosen by name — `variant:`, `size:`, `type:`, `padding:`, `spacing:`,

data/the_local/agents/keystone_ui-install.md

@@ -215,8 +215,9 @@ built on ViewComponent; hook it in before building any screen with those helpers
      A page that passes no Back link goes back to the trail's last link. A page
      that passes its own trail or Back link keeps it. With no supplier, or a
      `nil` return, the page shows its Back link. Return `nil`, not an empty
-     array, for a page with no trail, because an empty array replaces the
-     page's Back link with breadcrumbs holding only its title.
+     array, for a page with no trail. An empty array replaces the page's Back
+     link with breadcrumbs holding only its title, and on a page that passes
+     no Back link it raises `KeystoneUi::MissingBackLink`.
    - Every form and show page must end up with a Back link. A page that passes
      no Back link and no trail, and gets no trail from the supplier, raises
      `KeystoneUi::MissingBackLink` naming the page's title when it renders.

metadata

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