nitro_kit 0.1.0 → 0.3.0

data/app/components/nitro_kit/tabs.rb

@@ -0,0 +1,98 @@
+# frozen_string_literal: true
+
+module NitroKit
+  class Tabs < Component
+    def initialize(default: nil, **attrs)
+      @default = default
+      @id = attrs[:id] || SecureRandom.hex(6)
+
+      super(
+        attrs,
+        data: {controller: "nk--tabs", nk__tabs_active_value: default},
+        class: base_class
+      )
+    end
+
+    attr_reader :default, :id
+
+    def view_template
+      div(**attrs) do
+        yield
+      end
+    end
+
+    def tabs(**attrs)
+      div(**mattr, role: "tabtabs", class: tabs_class) do
+        yield
+      end
+    end
+
+    def tab(key, text = nil, **attrs, &block)
+      button(
+        **mattr(
+          attrs,
+          aria: {
+            selected: (default == key).to_s,
+            controls: tab_id(key, :panel)
+          },
+          class: tab_class,
+          data: {
+            action: "nk--tabs#setActiveTab keydown.left->nk--tabs#prevTab keydown.right->nk--tabs#nextTab",
+            key:,
+            nk__tabs_key_param: key,
+            nk__tabs_target: "tab"
+          },
+          id: tab_id(key, :tab),
+          role: "tab",
+          tabindex: default == key ? 0 : -1
+        )
+      ) do
+        text_or_block(text, &block)
+      end
+    end
+
+    def panel(key, **attrs)
+      div(
+        **mattr(
+          attrs,
+          aria: {
+            hidden: (default != key).to_s,
+            labelledby: tab_id(key, :tab)
+          },
+          class: panel_class,
+          data: {
+            key:,
+            nk__tabs_target: "panel"
+          },
+          id: tab_id(key, :panel),
+          name: key,
+          role: "tabpanel"
+        )
+      ) do
+        yield
+      end
+    end
+
+    private
+
+    def tab_id(key, suffix)
+      "#{id}-#{key}-#{suffix}"
+    end
+
+    def base_class
+      "w-full"
+    end
+
+    def tabs_class
+      "flex gap-4 border-b h-10"
+    end
+
+    def tab_class
+      "border-b-2 border-transparent hover:border-primary focus-visible:border-primary cursor-pointer text-muted-foreground aria-[selected=true]:text-foreground font-medium aria-[selected=true]:border-primary -mb-px px-2"
+    end
+
+    def panel_class
+      "aria-[hidden=true]:hidden py-4"
+    end
+  end
+end

data/app/components/nitro_kit/textarea.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module NitroKit
+  class Textarea < Component
+    def initialize(**attrs)
+      super(
+        attrs,
+        class: default_class
+      )
+    end
+
+    def view_template
+      textarea(**attrs)
+    end
+
+    private
+
+    def default_class
+      [
+        "rounded-md border bg-background border-border text-base px-3 py-2",
+        # Focus
+        "focus:outline-none ring-ring ring-offset-2 ring-offset-background focus-visible:ring-2"
+      ]
+    end
+  end
+end

data/app/components/nitro_kit/toast.rb

@@ -0,0 +1,104 @@
+# frozen_string_literal: true
+
+module NitroKit
+  class Toast < Component
+    class Item < Component
+      VARIANTS = %i[default warning error success]
+
+      def initialize(title: nil, description: nil, variant: :default, **attrs)
+        @title = title
+        @description = description
+        @variant = variant
+
+        super(
+          **mattr(
+            attrs,
+            class: [
+              base_class,
+              variant_class
+            ],
+            role: "status",
+            aria: {live: "off", atomic: "true"},
+            tabindex: "0",
+            data: {state: "closed"}
+          )
+        )
+      end
+
+      attr_reader :title, :description, :variant
+
+      def view_template(&block)
+        li(**attrs) do
+          div(class: "grid gap-1") do
+            div(class: "text-sm font-semibold", data: {slot: "title"}) do
+              title && plain(title)
+            end
+
+            div(class: "text-sm opacity-90", data: {slot: "description"}) do
+              text_or_block(description, &block)
+            end
+          end
+        end
+      end
+
+      private
+
+      def base_class
+        "shrink-0 pointer-events-auto relative flex w-full items-center justify-between space-x-4 overflow-hidden rounded-md p-4 pr-8 shadow-lg transition-all border opacity-0 transition-all data-[state=open]:opacity-100 data-[state=open]:-translate-y-full"
+      end
+
+      def variant_class
+        case variant
+        when :default
+          "border-border bg-background text-foreground"
+        when :warning
+          "bg-yellow-50 dark:bg-yellow-950 text-yellow-900 dark:text-yellow-100 border-yellow-500/80 dark:border-yellow-400/50"
+        when :success
+          "bg-green-50 dark:bg-green-950 text-green-900 dark:text-green-100 border-green-500/80 dark:border-green-400/50"
+        when :error
+          "bg-red-50 dark:bg-red-950 text-red-900 dark:text-red-100 border-red-400/80 dark:border-red-400/50"
+        else
+          raise ArgumentError, "Invalid variant `#{variant}'"
+        end
+      end
+    end
+
+    def initialize(**attrs)
+      super(
+        attrs,
+        role: "region",
+        tabindex: "-1",
+        aria: {label: "Notifications"},
+        class: "pointer-events-none"
+      )
+    end
+
+    def view_template
+      div(**attrs) do
+        ol(class: list_class, data: {nk__toast_target: "list"})
+      end
+
+      flash_sink
+
+      template(data: {nk__toast_target: "template"}) do
+        item
+      end
+    end
+
+    def item(title: nil, description: nil, **attrs, &block)
+      render(Item.new(title:, description:, **attrs), &block)
+    end
+
+    def flash_sink
+      div(id: "nk--toast-sink", data: {nk__toast_target: "sink"}, hidden: true) do
+        helpers.nk_toast_flash_messages
+      end
+    end
+
+    private
+
+    def list_class
+      "fixed z-[100] flex max-h-screen w-full p-5 bottom-0 right-0 flex-col h-0 md:max-w-[420px]"
+    end
+  end
+end

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,7 +1,9 @@
+# frozen_string_literal: true
+
 module NitroKit
   module AccordionHelper
     def nk_accordion(**attrs, &block)
       render(Accordion.new(**attrs), &block)
     end
   end
-end 
+end

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