layered-ui-rails 0.16.1 → 0.17.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8c6db00c8644f6d77f57044ddb722d85679aa1a212dcf97e343235dedc059aa6
-  data.tar.gz: 427a18c3eddf0676e5c9c6b92b13ac651c01a8d73b964a4d5c4ea5c683102cdc
+  metadata.gz: e39aa0c82625f31531a7c634bd1e30233b7b0c8beddd349ad3bd36225e0f580d
+  data.tar.gz: 71bedafdf65c00a1808debbc949ef8560d40d02f150afe89f844bd345437d124
 SHA512:
-  metadata.gz: c543aa25cc392198de7350249cc6e448d84513af39b3ca5e42f0e94058a94aa014fd05ceb8eaed7dc3427c88c791f704b86101bc7636c23ac9fdf42d5ad5c142
-  data.tar.gz: '003035092eee2d1a1aa9994829da39e532cf067f6a8248478d09a3ec5167cb09835fae97c7c808bc00087da9f4a2a643bdd8d7c600e4afe374ed3195be3f8ec3'
+  metadata.gz: 4104d1ccd55bf440a323975b6a06aace5346179c8fc06ad51fa037050ff25bfad540a075582d9f1c80587b127dd9176fef3ed98f8462c52f93cfb780b6e11802
+  data.tar.gz: d7ddafdb90cd018c340274602eb730079809bd35d1e1f807a729ebd41c4e76ff19c4a717bc0e3b8da735f821d3a1eb353804514acf8cbfa116592ef7343aa85b

data/.claude/skills/layered-ui-rails/SKILL.md

@@ -77,6 +77,28 @@ Populate layout regions with `content_for` (always above the render call):
 <% content_for :l_ui_logo_dark do %>
   <%= image_tag "my_logo_dark.svg", alt: "", class: "l-ui-header__logo l-ui-header__logo--dark" %>
 <% end %>
+
+<%# Prepend or append items to the header actions group %>
+<% content_for :l_ui_header_actions_start do %>
+  <%= link_to "Docs", docs_path, class: "l-ui-button l-ui-button--ghost l-ui-button--small" %>
+<% end %>
+<% content_for :l_ui_header_actions_end do %>
+  <%= link_to "Help", help_path, class: "l-ui-button l-ui-button--ghost l-ui-button--small" %>
+<% end %>
+
+<%# Or replace the default actions group entirely and compose with helpers %>
+<% content_for :l_ui_header_actions do %>
+  <%= link_to "Docs", docs_path, class: "l-ui-button l-ui-button--ghost l-ui-button--small" %>
+  <%= l_ui_theme_toggle %>
+  <%= l_ui_authentication %>
+  <%= l_ui_navigation_toggle %>
+<% end %>
+
+<%# Inline header links (alongside the logo) %>
+<% content_for :l_ui_header_links do %>
+  <%= link_to "Pricing", pricing_path %>
+  <%= link_to "About", about_path %>
+<% end %>
 ```
 
 Body class modifiers:
@@ -116,6 +138,9 @@ Quick reference:
 | `l_ui_normalise_field(record, config)` | Normalise a raw field config hash into canonical form |
 | `l_ui_user_signed_in?` | Check if user is authenticated |
 | `l_ui_current_user` | Current user object |
+| `l_ui_theme_toggle` | Default header theme toggle button |
+| `l_ui_authentication` | Default header login/register buttons (Devise) |
+| `l_ui_navigation_toggle` | Default header sidebar toggle button |
 
 ## CSS classes
 

data/.claude/skills/layered-ui-rails/references/HELPERS.md

@@ -208,7 +208,7 @@ Formats a date/time value as `"%-d %b %Y, %H:%M"` (e.g. "15 Apr 2026, 10:30"). R
 ## Form
 
 ```ruby
-l_ui_form(record, fields:, url:, method: nil, submit: nil)
+l_ui_form(record, fields:, url:, method: nil, submit: nil, multipart: nil)
 ```
 
 - `record` (ActiveRecord) - the model instance
@@ -216,16 +216,21 @@ l_ui_form(record, fields:, url:, method: nil, submit: nil)
 - `url` (String) - form action URL
 - `method` (Symbol, optional) - HTTP method override
 - `submit` (String, optional) - submit button text; defaults to "Create" for new records and "Save" for persisted records
+- `multipart` (Boolean, optional) - override multipart encoding. Defaults to auto-detection: `true` when any field is `:file`, otherwise `false`. Pass `true`/`false` to force.
+
+If you need control beyond these options, override the partial in your host app by creating `app/views/layered/ui/managed_resource/_form.html.erb` (Rails view lookup prefers the host's copy), or write the form directly with `form_with` and reuse `layered_ui/shared/form_errors`, `layered_ui/shared/label`, and `layered_ui/shared/field_error`.
 
 Renders a complete form with all fields, error summary, and submit button via the `layered/ui/managed_resource/form` partial.
 
 Field options:
 - `attribute` (Symbol) - model attribute
-- `as` (Symbol, optional) - field type; auto-detected from column type. Supported: `:string`, `:text`, `:email`, `:password`, `:number`, `:date`, `:datetime`, `:select`, `:checkbox`, `:hidden`
+- `as` (Symbol, optional) - field type; auto-detected from column type. Supported: `:string`, `:text`, `:email`, `:password`, `:number`, `:tel`, `:url`, `:search`, `:date`, `:datetime`, `:time`, `:month`, `:week`, `:color`, `:range`, `:file`, `:select`, `:checkbox`, `:hidden`. Forms automatically become `multipart` when any field is `:file`.
 - `label` (String, optional) - custom label text; defaults to humanised attribute
 - `required` (Boolean, optional) - marks field as required; default false
 - `hint` (String, optional) - help text below the field
 - `collection` (Array, optional) - required for `:select` type; e.g. `[['Label', value], ...]`
+- `include_blank` (Boolean or String, optional) - for `:select` fields; defaults to `true`. Pass a string to use as the blank option's label, or `false` to omit it. Suppressed when `prompt:` is set
+- `prompt` (String, optional) - for `:select` fields; prompt text shown as the first option, only selectable when no value is set
 - `placeholder` (String, optional) - input placeholder text
 
 ```erb
@@ -287,6 +292,25 @@ The button does not need to be inside the helper's wrapper, and no `data-control
 
 Calling `dialog.showModal()` directly is not supported - it bypasses the `l-ui--modal` controller and skips scroll lock, focus restoration, open-count tracking, and the screen-reader announcement.
 
+## Header
+
+```ruby
+l_ui_theme_toggle      # Renders the dark/light theme toggle button
+l_ui_authentication    # Renders Devise login/register buttons (no-op when signed in or when Devise routes are absent)
+l_ui_navigation_toggle # Renders the hamburger that toggles the sidebar (only when navigation items exist or a user is signed in)
+```
+
+Use these when overriding the header actions group with `:l_ui_header_actions` to compose your own bar from the default building blocks. The header also exposes `:l_ui_header_actions_start` and `:l_ui_header_actions_end` yields to prepend or append items without replacing the defaults, and `:l_ui_header_links` for inline links beside the logo.
+
+```erb
+<% content_for :l_ui_header_actions do %>
+  <%= link_to "Docs", docs_path, class: "l-ui-button l-ui-button--ghost l-ui-button--small" %>
+  <%= l_ui_theme_toggle %>
+  <%= l_ui_authentication %>
+  <%= l_ui_navigation_toggle %>
+<% end %>
+```
+
 ## Authentication
 
 ```ruby

data/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 All notable changes to this project will be documented in this file. This project follows [Semantic Versioning](https://semver.org/).
 
+## [0.17.0] - 2026-05-19
+
+### Added
+
+- `header_actions` helper for inserting custom action buttons into the layout header, alongside the existing authentication/theme/navigation toggles
+- Header partial split into `_authentication`, `_navigation_toggle`, and `_theme_toggle` sub-partials
+- Expanded `l_ui_form` field types: `tel`, `url`, `search`, `time`, `month`, `week`, `color`, `range`, and `file`
+- `multipart:` option on `l_ui_form` to override the form's multipart encoding (auto-detected from `:file` fields otherwise)
+- `prompt:` field option on `:select` fields in `l_ui_form`, shown as the first option and only selectable when no value is set; suppresses the default blank option
+
 ## [0.16.1] - 2026-05-16
 
 ### Fixed

data/app/helpers/layered/ui/form_helper.rb

@@ -1,7 +1,12 @@
 module Layered
   module Ui
     module FormHelper
-      FIELD_TYPES = %i[string text email password number date datetime select checkbox hidden].freeze
+      FIELD_TYPES = %i[
+        string text email password number tel url search
+        date datetime time month week
+        color range file
+        select checkbox hidden
+      ].freeze
 
       # Renders a complete form with all fields, error summary,
       # and submit button.
@@ -10,9 +15,10 @@ module Layered
       #     fields: Post.l_managed_resource_fields,
       #     url: managed_posts_path)
       #
-      def l_ui_form(record, fields:, url:, method: nil, submit: nil)
+      def l_ui_form(record, fields:, url:, method: nil, submit: nil, multipart: nil)
         render partial: "layered/ui/managed_resource/form",
-               locals: { record: record, fields: fields, url: url, method: method, submit: submit }
+               locals: { record: record, fields: fields, url: url, method: method,
+                         submit: submit, multipart: multipart }
       end
 
       # Normalises a raw field config hash into a canonical form.
@@ -35,7 +41,7 @@ module Layered
         label = config[:label] || attribute.to_s.humanize
 
         extras = config.except(:attribute, :as, :label, :required, :hint,
-                               :collection, :placeholder)
+                               :collection, :placeholder, :prompt, :include_blank)
 
         {
           attribute: attribute,
@@ -45,6 +51,8 @@ module Layered
           hint: config[:hint],
           collection: config[:collection],
           placeholder: config[:placeholder],
+          prompt: config[:prompt],
+          include_blank: config[:include_blank],
           extras: extras
         }
       end

data/app/helpers/layered/ui/header_helper.rb

@@ -0,0 +1,17 @@
+module Layered
+  module Ui
+    module HeaderHelper
+      def l_ui_theme_toggle
+        render "layouts/layered_ui/theme_toggle"
+      end
+
+      def l_ui_authentication
+        render "layouts/layered_ui/authentication"
+      end
+
+      def l_ui_navigation_toggle
+        render "layouts/layered_ui/navigation_toggle"
+      end
+    end
+  end
+end

data/app/views/layered/ui/managed_resource/_field_input.html.erb

@@ -25,11 +25,15 @@
   <%
     collection = config[:collection]
     choices = collection.respond_to?(:call) ? collection.call : collection
-    include_blank = extras.delete(:include_blank)
-    include_blank = true if include_blank.nil?
+    include_blank = config[:include_blank]
+    prompt = config[:prompt]
+    include_blank = true if include_blank.nil? && prompt.nil?
+    select_options = {}
+    select_options[:include_blank] = include_blank unless include_blank.nil?
+    select_options[:prompt] = prompt unless prompt.nil?
   %>
   <div class="l-ui-select-container">
-    <%= form.select(attribute, choices, { include_blank: include_blank },
+    <%= form.select(attribute, choices, select_options,
                     class: field_class.call("l-ui-select"), **base_opts, **extras) %>
   </div>
 <% elsif config[:as] == :checkbox %>
@@ -38,7 +42,13 @@
     <%= form.label(attribute, config[:label], class: "l-ui-checkbox-container__label") %>
   </div>
 <% else %>
-  <% method_name = config[:as] == :string ? :text_field : :"#{config[:as]}_field" %>
+  <%
+    method_name = case config[:as]
+                  when :string then :text_field
+                  when :tel then :telephone_field
+                  else :"#{config[:as]}_field"
+                  end
+  %>
   <%= form.public_send(method_name, attribute,
                        class: field_class.call("l-ui-form__field"), **base_opts, **extras) %>
 <% end %>

data/app/views/layered/ui/managed_resource/_form.html.erb

@@ -1,5 +1,7 @@
+<% multipart = local_assigns.fetch(:multipart, nil) %>
 <% form_opts = { url: url, class: "l-ui-form" } %>
 <% form_opts[:method] = method if method %>
+<% form_opts[:multipart] = multipart.nil? ? fields.any? { |f| f[:as] == :file } : multipart %>
 
 <%= form_with(model: record, **form_opts) do |f| %>
   <%= render "layered_ui/shared/form_errors", item: record %>

data/app/views/layouts/layered_ui/_authentication.html.erb

@@ -0,0 +1,9 @@
+<% unless l_ui_user_signed_in? %>
+  <% if respond_to?(:new_user_registration_path) %>
+    <%= link_to "Register", main_app.new_user_registration_path, class: "l-ui-button l-ui-button--outline l-ui-button--small" %>
+  <% end %>
+
+  <% if respond_to?(:new_user_session_path) %>
+    <%= link_to "Login", main_app.new_user_session_path, class: "l-ui-button l-ui-button--primary l-ui-button--small" %>
+  <% end %>
+<% end %>

data/app/views/layouts/layered_ui/_header.html.erb

@@ -14,42 +14,14 @@
     <% end %>
 
     <nav class="l-ui-header__navigation" aria-label="Header navigation">
-      <button
-        type="button"
-        data-controller="l-ui--theme"
-        data-action="click->l-ui--theme#toggle"
-        data-l-ui--theme-target="button"
-        class="l-ui-button l-ui-button--icon l-ui-theme-toggle"
-        aria-label="Toggle dark mode"
-        aria-pressed="false"
-      >
-        <%= image_tag "layered_ui/icon_moon.svg", alt: "", class: "l-ui-icon l-ui-icon--sm l-ui-theme-toggle__icon l-ui-theme-toggle__icon--light", aria: { hidden: true } %>
-        <%= image_tag "layered_ui/icon_sun.svg", alt: "", class: "l-ui-icon l-ui-icon--sm l-ui-theme-toggle__icon l-ui-theme-toggle__icon--dark", aria: { hidden: true } %>
-      </button>
-
-      <% unless l_ui_user_signed_in? %>
-        <% if respond_to?(:new_user_registration_path) %>
-          <%= link_to "Register", main_app.new_user_registration_path, class: "l-ui-button l-ui-button--outline l-ui-button--small" %>
-        <% end %>
-
-        <% if respond_to?(:new_user_session_path) %>
-          <%= link_to "Login", main_app.new_user_session_path, class: "l-ui-button l-ui-button--primary l-ui-button--small" %>
-        <% end %>
-      <% end %>
-
-      <% if yield(:l_ui_navigation_items).present? || l_ui_user_signed_in? %>
-        <button
-          type="button"
-          class="l-ui-button l-ui-button--navigation-toggle"
-          data-action="click->l-ui--navigation#toggle"
-          data-l-ui--navigation-target="toggleButton"
-          aria-label="Toggle navigation menu"
-          aria-expanded="false"
-          aria-controls="l-ui-navigation"
-        >
-          <%= image_tag "layered_ui/icon_hamburger.svg", alt: "", class: "l-ui-icon l-ui-icon--md", data: { "l-ui--navigation-target": "openIcon" }, aria: { hidden: true } %>
-          <%= image_tag "layered_ui/icon_close.svg", alt: "", class: "l-ui-icon l-ui-icon--md", style: "display: none;", data: { "l-ui--navigation-target": "closeIcon" }, aria: { hidden: true } %>
-        </button>
+      <% if content_for?(:l_ui_header_actions) %>
+        <%= yield(:l_ui_header_actions) %>
+      <% else %>
+        <%= yield(:l_ui_header_actions_start) %>
+        <%= l_ui_theme_toggle %>
+        <%= l_ui_authentication %>
+        <%= l_ui_navigation_toggle %>
+        <%= yield(:l_ui_header_actions_end) %>
       <% end %>
     </nav>
   </div>

data/app/views/layouts/layered_ui/_navigation_toggle.html.erb

@@ -0,0 +1,14 @@
+<% if yield(:l_ui_navigation_items).present? || l_ui_user_signed_in? %>
+  <button
+    type="button"
+    class="l-ui-button l-ui-button--navigation-toggle"
+    data-action="click->l-ui--navigation#toggle"
+    data-l-ui--navigation-target="toggleButton"
+    aria-label="Toggle navigation menu"
+    aria-expanded="false"
+    aria-controls="l-ui-navigation"
+  >
+    <%= image_tag "layered_ui/icon_hamburger.svg", alt: "", class: "l-ui-icon l-ui-icon--md", data: { "l-ui--navigation-target": "openIcon" }, aria: { hidden: true } %>
+    <%= image_tag "layered_ui/icon_close.svg", alt: "", class: "l-ui-icon l-ui-icon--md", style: "display: none;", data: { "l-ui--navigation-target": "closeIcon" }, aria: { hidden: true } %>
+  </button>
+<% end %>

data/app/views/layouts/layered_ui/_theme_toggle.html.erb

@@ -0,0 +1,12 @@
+<button
+  type="button"
+  data-controller="l-ui--theme"
+  data-action="click->l-ui--theme#toggle"
+  data-l-ui--theme-target="button"
+  class="l-ui-button l-ui-button--icon l-ui-theme-toggle"
+  aria-label="Toggle dark mode"
+  aria-pressed="false"
+>
+  <%= image_tag "layered_ui/icon_moon.svg", alt: "", class: "l-ui-icon l-ui-icon--sm l-ui-theme-toggle__icon l-ui-theme-toggle__icon--light", aria: { hidden: true } %>
+  <%= image_tag "layered_ui/icon_sun.svg", alt: "", class: "l-ui-icon l-ui-icon--sm l-ui-theme-toggle__icon l-ui-theme-toggle__icon--dark", aria: { hidden: true } %>
+</button>

data/lib/layered/ui/engine.rb

@@ -33,6 +33,7 @@ module Layered
           helper Layered::Ui::TableHelper
           helper Layered::Ui::TitleBarHelper
           helper Layered::Ui::FormHelper
+          helper Layered::Ui::HeaderHelper
           helper Layered::Ui::ModalHelper
           helper Layered::Ui::RansackHelper
         end

data/lib/layered/ui/version.rb

@@ -1,5 +1,5 @@
 module Layered
   module Ui
-    VERSION = "0.16.1"
+    VERSION = "0.17.0"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: layered-ui-rails
 version: !ruby/object:Gem::Version
-  version: 0.16.1
+  version: 0.17.0
 platform: ruby
 authors:
 - layered.ai
@@ -213,6 +213,7 @@ files:
 - app/helpers/layered/ui/authentication_helper.rb
 - app/helpers/layered/ui/breadcrumbs_helper.rb
 - app/helpers/layered/ui/form_helper.rb
+- app/helpers/layered/ui/header_helper.rb
 - app/helpers/layered/ui/modal_helper.rb
 - app/helpers/layered/ui/navigation_helper.rb
 - app/helpers/layered/ui/pagy_helper.rb
@@ -253,10 +254,13 @@ files:
 - app/views/layered_ui/shared/_label.html.erb
 - app/views/layered_ui/shared/_search_field.html.erb
 - app/views/layered_ui/shared/_search_select.html.erb
+- app/views/layouts/layered_ui/_authentication.html.erb
 - app/views/layouts/layered_ui/_header.html.erb
 - app/views/layouts/layered_ui/_navigation.html.erb
+- app/views/layouts/layered_ui/_navigation_toggle.html.erb
 - app/views/layouts/layered_ui/_notice.html.erb
 - app/views/layouts/layered_ui/_panel.html.erb
+- app/views/layouts/layered_ui/_theme_toggle.html.erb
 - app/views/layouts/layered_ui/application.html.erb
 - config/importmap.rb
 - lib/generators/layered/ui/copy_assets_generator.rb