nitro_kit 0.2.0 → 0.3.0

data/app/components/nitro_kit/tooltip.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+module NitroKit
+  class Tooltip < Component
+    def initialize(content: nil, placement: nil, **attrs)
+      @string_content = content
+      @placement = placement
+
+      super(
+        attrs,
+        data: {
+          action: "mouseover->nk--tooltip#open mouseout->nk--tooltip#close",
+          controller: "nk--tooltip",
+          nk__tooltip_placement_value: placement
+        }
+      )
+    end
+
+    attr_reader :placement, :string_content
+
+    def view_template
+      span(**attrs) do
+        content(string_content) if string_content
+        yield
+      end
+    end
+
+    def content(text = nil, **attrs, &block)
+      div(
+        **mattr(
+          attrs,
+          class: tooltip_class,
+          data: {
+            state: "closed",
+            nk__tooltip_target: "content"
+          }
+        )
+      ) do
+        text_or_block(text, &block)
+      end
+    end
+
+    private
+
+    def tooltip_class
+      [
+        "absolute z-50 overflow-hidden w-fit max-w-sm",
+        "px-3 py-1.5 text-sm bg-background rounded-md border shadow-sm",
+        "data-[state=closed]:hidden"
+      ]
+    end
+  end
+end

data/app/helpers/nitro_kit/accordion_helper.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module NitroKit
   module AccordionHelper
     def nk_accordion(**attrs, &block)

data/app/helpers/nitro_kit/alert_helper.rb

@@ -0,0 +1,11 @@
+module NitroKit
+  module AlertHelper
+    include Variants
+
+    def nk_alert(**attrs, &block)
+      render(Alert.new(**attrs), &block)
+    end
+
+    automatic_variants(Alert::VARIANTS, :nk_alert)
+  end
+end

data/app/helpers/nitro_kit/avatar_helper.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module NitroKit
+  module AvatarHelper
+    def nk_avatar(src = nil, **attrs, &block)
+      render(Avatar.new(src, **attrs), &block)
+    end
+  end
+end

data/app/helpers/nitro_kit/badge_helper.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module NitroKit
   module BadgeHelper
     include Variants
@@ -5,11 +7,7 @@ module NitroKit
     automatic_variants(Badge::VARIANTS, :nk_badge)
 
     def nk_badge(text = nil, **attrs, &block)
-      content = text || capture(&block)
-
-      render(NitroKit::Badge.new(**attrs)) do
-        content
-      end
+      render(NitroKit::Badge.new(text, **attrs), &block)
     end
   end
 end

data/app/helpers/nitro_kit/button_group_helper.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module NitroKit
   module ButtonGroupHelper
     def nk_button_group(**attrs, &block)

data/app/helpers/nitro_kit/button_helper.rb

@@ -1,40 +1,49 @@
+# frozen_string_literal: true
+
 module NitroKit
   module ButtonHelper
     include Variants
 
+    def nk_button(text = nil, **attrs, &block)
+      render(NitroKit::Button.new(text, **attrs), &block)
+    end
+
     automatic_variants(Button::VARIANTS, :nk_button)
 
-    def nk_button(
-      text_or_href = nil,
-      href = nil,
-      icon: nil,
-      icon_right: nil,
-      size: :base,
-      type: :button,
-      variant: :default,
-      **attrs,
-      &block
-    )
-      content = block_given? ? capture(&block) : text_or_href
-      href = text_or_href if href.nil? && block_given?
-
-      if href && !href.is_a?(String)
-        href = url_for(href)
+    # Matches the API of UrlHelper#button_to
+    def nk_button_to(name = nil, url_for_options = nil, **attrs, &block)
+      url_for_options = name if block_given?
+
+      form_options = attrs.delete(:form) || {}
+      form_options.merge!(attrs.slice(:multipart, :data, :method, :authenticity_token, :remote, :enforce_utf8))
+
+      form_tag(url_for_options, form_options) do
+        nk_button(name, type: "submit", **attrs, &block)
       end
+    end
 
-      render(
-        NitroKit::Button.new(
-          href:,
-          icon:,
-          icon_right:,
-          size:,
-          type:,
-          variant:,
-          **attrs
-        )
-      ) do
-        content
+    automatic_variants(Button::VARIANTS, :nk_button_to)
+
+    # Matches the API of UrlHelper#link_to
+    def nk_button_link_to(*args, **attrs, &block)
+      case args.length
+      when 1
+        options, text = args
+      when 2
+        text, options = args
+      else
+        raise ArgumentError, "1..2 arguments expected, got #{args.length}"
       end
+
+      href = attrs[:href] || url_target(text, options)
+
+      render(NitroKit::Button.new(text, **attrs, href:), &block)
+    end
+
+    automatic_variants(Button::VARIANTS, :nk_button_link_to)
+
+    def nk_button_group(**attrs, &block)
+      render(ButtonGroup.new(**attrs), &block)
     end
   end
 end

data/app/helpers/nitro_kit/card_helper.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module NitroKit
   module CardHelper
     def nk_card(**attrs, &block)

data/app/helpers/nitro_kit/checkbox_helper.rb

@@ -1,24 +1,27 @@
+# frozen_string_literal: true
+
 module NitroKit
   module CheckboxHelper
-    # Match the signature of the Rails `check_box` helper
-    def nk_checkbox(name, *args)
-      if args.length >= 4
-        raise ArgumentError, "wrong number of arguments (given #{args.length + 1}, expected 1..4)"
-      end
-
-      options = args.extract_options!
-      value, checked = args.empty? ? ["1", false] : [*args, false]
+    # Make API compatible with Rails' checkbox but allow empty arguments
+    def nk_checkbox(
+      compat_object_name = nil,
+      compat_method = nil,
+      compat_options = {},
+      compat_checked_value = "1",
+      compat_unchecked_value = "0",
+      label: nil,
+      **attrs
+    )
+      name = field_name(compat_object_name, compat_method)
+      checked = compat_options["checked"] || attrs[:checked]
 
-      attrs = {
-        :type => "checkbox",
-        :name => name,
-        :id => sanitize_to_id(name),
-        :value => value
-      }.update(options.symbolize_keys)
+      # TODO: multiple, unchecked hidden field
 
-      attrs[:checked] = "checked" if checked
+      render(Checkbox.new(name:, label:, value: compat_checked_value, checked:, **attrs))
+    end
 
-      render(NitroKit::Checkbox.new(name, value:, **attrs))
+    def nk_checkbox_group(**attrs, &block)
+      render(CheckboxGroup.new(**attrs), &block)
     end
   end
 end

data/app/helpers/nitro_kit/combobox_helper.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module NitroKit
+  module ComboboxHelper
+    def nk_combobox(name = nil, options = [], **attrs)
+      render(NitroKit::Combobox.new(name:, options:, **attrs))
+    end
+  end
+end

data/app/helpers/nitro_kit/datepicker_helper.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module NitroKit
+  module DatepickerHelper
+    def nk_datepicker(**attrs, &block)
+      render(Datepicker.new(**attrs), &block)
+    end
+  end
+end

data/app/helpers/nitro_kit/dialog_helper.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module NitroKit
+  module DialogHelper
+    def nk_dialog(**attrs, &block)
+      render(Dialog.new(**attrs), &block)
+    end
+  end
+end

data/app/helpers/nitro_kit/dropdown_helper.rb

@@ -1,7 +1,9 @@
+# frozen_string_literal: true
+
 module NitroKit
   module DropdownHelper
     def nk_dropdown(**attrs, &block)
-      render(NitroKit::Dropdown.new(**attrs), &block)
+      render(Dropdown.new(**attrs), &block)
     end
   end
 end

data/app/helpers/nitro_kit/field_group_helper.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module NitroKit
+  module FieldGroupHelper
+    def nk_field_group(**attrs)
+      render(NitroKit::FieldGroup.new(**attrs)) { yield }
+    end
+  end
+end

data/app/helpers/nitro_kit/field_helper.rb

@@ -1,7 +1,9 @@
+# frozen_string_literal: true
+
 module NitroKit
   module FieldHelper
-    def nk_field(*args, **options, &block)
-      render(NitroKit::Field.new(*args, **options, &block))
+    def nk_field(*args, **attrs, &block)
+      render(NitroKit::Field.new(*args, **attrs), &block)
     end
   end
 end

data/app/helpers/nitro_kit/fieldset_helper.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module NitroKit
+  module FieldsetHelper
+    def nk_fieldset(**attrs, &block)
+      render(NitroKit::Fieldset.new(**attrs), &block)
+    end
+  end
+end

data/app/helpers/nitro_kit/form_helper.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module NitroKit
+  module FormHelper
+    def nk_form_with(**attrs, &block)
+      form_with(**attrs, builder: NitroKit::FormBuilder, &block)
+    end
+
+    def nk_form_for(*args, **attrs, &block)
+      form_for(*args, **attrs, builder: NitroKit::FormBuilder, &block)
+    end
+  end
+end

data/app/helpers/nitro_kit/icon_helper.rb

@@ -1,7 +1,9 @@
+# frozen_string_literal: true
+
 module NitroKit
   module IconHelper
     def nk_icon(name, **attrs)
-      render(NitroKit::Icon.new(name: name, **attrs))
+      render(NitroKit::Icon.new(name, **attrs))
     end
   end
 end

data/app/helpers/nitro_kit/input_helper.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module NitroKit
+  module InputHelper
+    def nk_input(**attrs)
+      render(Input.new(**attrs))
+    end
+
+    %w[
+      color
+      date
+      datetime
+      datetime_local
+      email
+      file
+      hidden
+      month
+      number
+      password
+      phone
+      range
+      search
+      telephone
+      text
+      time
+      url
+      week
+    ]
+      .each do |type|
+        define_method("nk_#{type}_field") do |**attrs|
+          nk_input(type:, **attrs)
+        end
+      end
+  end
+end

data/app/helpers/nitro_kit/label_helper.rb

@@ -1,16 +1,19 @@
+# frozen_string_literal: true
+
 module NitroKit
   module LabelHelper
-    def nk_label(name = nil, content_or_options = nil, **attrs, &block)
-      if block_given? && content_or_options.is_a?(Hash)
-        attrs = content_or_options = content_or_options.symbolize_keys
-      else
-        attrs ||= {}
-        attrs = attrs.symbolize_keys
-      end
+    def nk_label(compat_object_name = nil, compat_method = nil, content_or_options = nil, **attrs, &block)
+      name = field_name(compat_object_name, compat_method)
 
-      attrs[:for] = sanitize_to_id(name) unless name.blank? || attrs.has_key?("for")
+      case content_or_options
+      when String
+        text = content_or_options
+      when Hash
+        text = nil
+        attrs.merge!(content_or_options)
+      end
 
-      render(Label.new(**attrs)) { content_or_options || name.to_s.humanize || yield }
+      render(Label.new(text, for: name, **attrs), &block)
     end
   end
 end

data/app/helpers/nitro_kit/pagination_helper.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module NitroKit
+  module PaginationHelper
+    include Pagy::UrlHelpers if defined?(Pagy)
+
+    def nk_pagination(**attrs, &block)
+      render(Pagination.new(**attrs), &block)
+    end
+
+    def nk_pagy_nav(pagy, id: nil, aria_label: nil, **attrs)
+      attrs[:aria] ||= {label: aria_label}
+
+      nk_pagination(id:, **attrs) do |p|
+        if prev_page = pagy.prev
+          p.prev(href: pagy_url_for(pagy, prev_page))
+        else
+          p.prev(disabled: true)
+        end
+
+        pagy.series.each do |item|
+          case item
+          when Integer
+            p.page(item.to_s, href: pagy_url_for(pagy, item))
+          when String
+            p.page(item, current: true)
+          when :gap
+            p.ellipsis
+          else
+            raise ArgumentError, "Unknown item type: #{item.class}"
+          end
+        end
+
+        if next_page = pagy.next
+          p.next(href: pagy_url_for(pagy, next_page))
+        else
+          p.next(disabled: true)
+        end
+      end
+    end
+  end
+end

data/app/helpers/nitro_kit/radio_button_helper.rb

@@ -1,20 +1,23 @@
+# frozen_string_literal: true
+
 module NitroKit
   module RadioButtonHelper
-    def nk_radio_button(name, value, *args)
-      if args.length >= 3
-        raise ArgumentError, "wrong number of arguments (given #{args.length + 2}, expected 2..4)"
-      end
-
-      options = args.extract_options!
-      checked = args.empty? ? false : args.first
-
-      options[:checked] = "checked" if checked
+    def nk_radio_button(
+      compat_object_name = nil,
+      compat_method = nil,
+      compat_tag_value = nil,
+      compat_options = {},
+      label: nil,
+      **attrs
+    )
+      name = field_name(compat_object_name, compat_method)
+      value = compat_tag_value || attrs[:value]
 
-      render(RadioButton.new(name, value:, name:, value:, **options))
+      render(RadioButton.new(label:, name:, value:, **attrs))
     end
 
-    def nk_radio_group(name, **options, &block)
-      render(RadioGroup.new(name, **options, &block))
+    def nk_radio_button_group(**attrs, &block)
+      render(RadioButtonGroup.new(**attrs), &block)
     end
   end
 end

data/app/helpers/nitro_kit/select_helper.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module NitroKit
+  module SelectHelper
+    def nk_select(
+      compat_object_name = nil,
+      compat_method = nil,
+      options = nil,
+      compat_options = {},
+      value: nil,
+      include_blank: false,
+      prompt: nil,
+      index: nil,
+      **attrs,
+      &block
+    )
+      name = field_name(compat_object_name, compat_method)
+
+      # TODO: support index
+
+      render(Select.new(options, value:, include_blank:, prompt:, **compat_options, **attrs), &block)
+    end
+  end
+end

data/app/helpers/nitro_kit/switch_helper.rb

@@ -1,15 +1,9 @@
+# frozen_string_literal: true
+
 module NitroKit
   module SwitchHelper
-    def nk_switch(
-      name,
-      checked: false,
-      disabled: false,
-      size: :base,
-      description: nil,
-      **attrs,
-      &block
-    )
-      render(NitroKit::Switch.new(name, checked:, disabled:, size:, description:, **attrs), &block)
+    def nk_switch(**attrs, &block)
+      render(Switch.new(**attrs), &block)
     end
   end
 end

data/app/helpers/nitro_kit/table_helper.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module NitroKit
+  module TableHelper
+    def nk_table(**attrs, &block)
+      render(Table.new(**attrs), &block)
+    end
+  end
+end

data/app/helpers/nitro_kit/tabs_helper.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module NitroKit
+  module TabsHelper
+    def nk_tabs(**attrs, &block)
+      render(Tabs.new(**attrs), &block)
+    end
+  end
+end

data/app/helpers/nitro_kit/textarea_helper.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module NitroKit
+  module TextareaHelper
+    def nk_textarea(**attrs)
+      render(Textarea.new(**attrs))
+    end
+  end
+end

data/app/helpers/nitro_kit/toast_helper.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module NitroKit
+  module ToastHelper
+    def nk_toast(**attrs, &block)
+      render(Toast.new(**attrs), &block)
+    end
+
+    def nk_toast_action(title: nil, description: nil, event: nil)
+      {
+        action: "#{event ? "#{event}->" : ""}nk--toast#toast",
+        nk__toast_title_param: title,
+        nk__toast_description_param: description
+      }
+    end
+
+    def nk_toast_flash_messages
+      capture do
+        flash.each do |severity, message|
+          concat(
+            render(
+              Toast::Item.new(
+                description: message,
+                variant: severity.to_sym == :alert ? :error : :default
+              )
+            )
+          )
+        end
+      end
+    end
+
+    def nk_toast_turbo_stream_refresh
+      turbo_stream.append("nk--toast-sink", nk_toast_flash_messages)
+    end
+  end
+end

data/app/helpers/nitro_kit/tooltip_helper.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module NitroKit
+  module TooltipHelper
+    def nk_tooltip(**attrs, &block)
+      render(Tooltip.new(**attrs), &block)
+    end
+  end
+end