nitro_kit 0.1.0

data/app/components/nitro_kit/radio_group.rb

@@ -0,0 +1,35 @@
+module NitroKit
+  class RadioGroup < Component
+    include ActionView::Helpers::FormTagHelper
+
+    def initialize(name, value: nil, **options)
+      super(**options)
+      @name = name
+      @group_value = value
+    end
+
+    attr_reader :name, :id, :group_value
+
+    def view_template
+      div(class: "flex items-start flex-col gap-2") do
+        yield
+      end
+    end
+
+    def title(text = nil, **options)
+      render(Label.new(**options)) { text || yield }
+    end
+
+    def item(value, text = nil, **options)
+      render(
+        RadioButton.new(
+          name,
+          id:,
+          value:,
+          checked: group_value.presence == value,
+          **options
+        )
+      ) { text || yield }
+    end
+  end
+end

data/app/components/nitro_kit/switch.rb

@@ -0,0 +1,66 @@
+module NitroKit
+  class Switch < Component
+    BUTTON = [
+      "inline-flex items-center shrink-0",
+      "bg-background rounded-full border",
+      "transition-colors duration-200 ease-in-out",
+      "focus:outline-none focus:ring-2 focus:ring-ring focus:ring-offset-2 ring-offset-background",
+
+      # Checked
+      "[&[aria-checked='true']]:bg-foreground [&[aria-checked='true']]:border-foreground",
+
+      # Checked > Handle
+      "[&[aria-checked='false']_[data-slot='handle']]:bg-primary",
+      "[&[aria-checked='true']_[data-slot='handle']]:translate-x-[calc(theme(spacing.5)-1px)] [&[aria-checked='true']_[data-slot='handle']]:bg-background"
+    ].freeze
+
+    HANDLE = [
+      "pointer-events-none inline-block rounded-full shadow ring-0",
+      "transition translate-x-[3px] duration-200 ease-in-out"
+    ].freeze
+
+    SIZE = {
+      base: "h-6 w-10 [&_[data-slot=handle]]:size-4 [&[aria-checked='true']_[data-slot='handle']]:translate-x-[calc(theme(spacing.5)-1px)]",
+      sm: "h-5 w-8 [&_[data-slot=handle]]:size-3 [&[aria-checked='true']_[data-slot='handle']]:translate-x-[calc(theme(spacing.4)-1px)]"
+    }
+
+    def initialize(
+      name,
+      checked: false,
+      disabled: false,
+      size: :base,
+      description: nil,
+      **attrs
+    )
+      super(**attrs)
+
+      @name = name
+      @checked = checked
+      @disabled = disabled
+      @size = size
+      @description = description
+    end
+
+    attr_reader :name, :checked, :disabled, :description, :size
+
+    def view_template
+      button(
+        **attrs,
+        type: "button",
+        class: merge([BUTTON, SIZE[size], attrs[:class]]),
+        data: data_merge(attrs[:data], {controller: "nk--switch", action: "nk--switch#switch"}),
+        role: "switch",
+        aria: {checked: checked.to_s}
+      ) do
+        span(class: "sr-only") { description }
+        handle
+      end
+    end
+
+    private
+
+    def handle
+      span(aria: {hidden: true}, class: HANDLE, data: {slot: "handle"})
+    end
+  end
+end

data/app/helpers/application_helper.rb

@@ -0,0 +1,89 @@
+module ApplicationHelper
+  def component_page(&block)
+    tag.div(class: "p-5") do
+      capture(&block)
+    end
+  end
+
+  def title(text)
+    tag.h1(class: "text-3xl font-semibold mb-6") { text }
+  end
+
+  def lead(text)
+    tag.p(class: "text-lg text-gray-600 dark:text-gray-400 mb-6") { text }
+  end
+
+  def section(**attrs)
+    tag.div(**attrs, class: class_names("mt-8 space-y-4", attrs[:class])) { yield }
+  end
+
+  def section_title(text)
+    tag.h2(class: "text-2xl font-semibold mb-4") { text }
+  end
+
+  def example(**attrs)
+    tag
+      .div(
+        **attrs,
+        class: class_names(
+          ["flex gap-2 justify-center items-center min-h-[200px] py-12 p-5 w-full rounded border", attrs[:class]]
+        )
+      ) do
+        yield
+      end
+  end
+
+  def code_example(str)
+    formatter = Rouge::Formatters::HTML.new
+    lexer = Rouge::Lexers::ERB.new
+
+    tag
+      .div(
+        class: "bg-[#f7f8fa] dark:bg-[#161b22] divide-y border rounded overflow-hidden",
+        data: {controller: "copy-to-clipboard"}
+      ) do
+        concat(
+          tag.div(class: "px-1 py-1 flex w-full") do
+            concat(
+              nk_ghost_button(
+                icon: :copy,
+                size: :xs,
+                data: {copy_to_clipboard_target: "button", action: "copy-to-clipboard#copy"}
+              ) { "Copy" }
+            )
+            concat(
+              nk_ghost_button(
+                icon: :check,
+                size: :xs,
+                data: {copy_to_clipboard_target: "successMessage"},
+                class: "hidden"
+              ) { "Copied!" }
+            )
+          end
+        )
+
+        concat(
+          tag
+            .pre(
+              class: "text-sm highlight py-3 px-4 font-mono overflow-scroll",
+              data: {copy_to_clipboard_target: "source"}
+            ) do
+              tag.code do
+                formatter.format(lexer.lex(str.strip_heredoc.strip)).html_safe
+              end
+            end
+        )
+      end
+  end
+
+  def markdown(str)
+    Commonmarker
+      .to_html(
+        str.strip_heredoc,
+        options: {
+          parse: {smart: true}
+        }
+      )
+      .html_safe
+  end
+end

data/app/helpers/nitro_kit/accordion_helper.rb

@@ -0,0 +1,7 @@
+module NitroKit
+  module AccordionHelper
+    def nk_accordion(**attrs, &block)
+      render(Accordion.new(**attrs), &block)
+    end
+  end
+end 

data/app/helpers/nitro_kit/badge_helper.rb

@@ -0,0 +1,15 @@
+module NitroKit
+  module BadgeHelper
+    include Variants
+
+    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
+    end
+  end
+end

data/app/helpers/nitro_kit/button_group_helper.rb

@@ -0,0 +1,7 @@
+module NitroKit
+  module ButtonGroupHelper
+    def nk_button_group(**attrs, &block)
+      render(ButtonGroup.new(**attrs), &block)
+    end
+  end
+end

data/app/helpers/nitro_kit/button_helper.rb

@@ -0,0 +1,40 @@
+module NitroKit
+  module ButtonHelper
+    include Variants
+
+    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)
+      end
+
+      render(
+        NitroKit::Button.new(
+          href:,
+          icon:,
+          icon_right:,
+          size:,
+          type:,
+          variant:,
+          **attrs
+        )
+      ) do
+        content
+      end
+    end
+  end
+end

data/app/helpers/nitro_kit/card_helper.rb

@@ -0,0 +1,7 @@
+module NitroKit
+  module CardHelper
+    def nk_card(**attrs, &block)
+      render(Card.new(**attrs), &block)
+    end
+  end
+end

data/app/helpers/nitro_kit/checkbox_helper.rb

@@ -0,0 +1,24 @@
+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]
+
+      attrs = {
+        :type => "checkbox",
+        :name => name,
+        :id => sanitize_to_id(name),
+        :value => value
+      }.update(options.symbolize_keys)
+
+      attrs[:checked] = "checked" if checked
+
+      render(NitroKit::Checkbox.new(name, value:, **attrs))
+    end
+  end
+end

data/app/helpers/nitro_kit/dropdown_helper.rb

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

data/app/helpers/nitro_kit/field_helper.rb

@@ -0,0 +1,7 @@
+module NitroKit
+  module FieldHelper
+    def nk_field(attribute, **options)
+      render(NitroKit::Field.new(attribute, **options))
+    end
+  end
+end

data/app/helpers/nitro_kit/icon_helper.rb

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

data/app/helpers/nitro_kit/label_helper.rb

@@ -0,0 +1,15 @@
+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
+      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 }
+    end
+  end
+end

data/app/helpers/nitro_kit/radio_button_helper.rb

@@ -0,0 +1,20 @@
+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
+
+      render(RadioButton.new(name, value:, name:, value:, **options))
+    end
+
+    def nk_radio_group(name, **options, &block)
+      render(RadioGroup.new(name, **options, &block))
+    end
+  end
+end

data/app/helpers/nitro_kit/switch_helper.rb

@@ -0,0 +1,15 @@
+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)
+    end
+  end
+end

data/lib/generators/nitro_kit/add_generator.rb

@@ -0,0 +1,87 @@
+require "nitro_kit/schema_builder"
+
+module NitroKit
+  class AddGenerator < Rails::Generators::Base
+    argument :component_names, type: :array
+
+    source_root File.expand_path("../../../", __dir__)
+
+    extend SchemaBuilder
+
+    SCHEMA = build_schema do |s|
+      s.add(:badge)
+      s.add(
+        :button,
+        components: [:button, :button_group],
+        helpers: [:button, :button_group]
+      )
+      s.add(
+        :dropdown,
+        js: [:dropdown],
+        modules: ["@floating-ui/core", "@floating-ui/dom"]
+      )
+      s.add(
+        :icon,
+        gems: ["lucide-rails"]
+      )
+    end
+
+    def copy_base_component
+      copy_file("app/components/nitro_kit/component.rb", "app/components/nitro_kit/component.rb")
+    end
+
+    def copy_component_files
+      components.each do |component|
+        component.files.each do |path|
+          copy_file(path, path)
+        end
+      end
+    end
+
+    def add_gems
+      gems = components.flat_map(&:gems)
+
+      return unless gems.any?
+
+      gems.each do |name|
+        gem(name)
+      end
+
+      run("bundle install")
+    end
+
+    def install_modules
+      modules = components.flat_map(&:modules)
+
+      return unless modules.any?
+
+      if importmaps?
+        run("bin/importmap pin #{modules.join(" ")}")
+      else
+        say("oh hai npm/yarn/bun")
+      end
+    end
+
+    private
+
+    def components
+      list = component_names
+
+      if list == ["all"]
+        list = SCHEMA.all
+      end
+
+      list.map do |name|
+        unless component = SCHEMA[name.to_sym]
+          raise "Unknown component `#{name}'"
+        end
+
+        component
+      end
+    end
+
+    def importmaps?
+      File.exist?(File.expand_path("bin/importmap", Rails.root))
+    end
+  end
+end

data/lib/generators/nitro_kit/install_generator.rb

@@ -0,0 +1,9 @@
+module NitroKit
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      def one
+        puts("hi")
+      end
+    end
+  end
+end

data/lib/nitro_kit/railtie.rb

@@ -0,0 +1,8 @@
+module NitroKit
+  class Railtie < ::Rails::Railtie
+    initializer("nitro_kit.initialize") do
+      # Ignore our generators as they confuse Zeitwerk
+      Rails.autoloaders.main.ignore(File.expand_path("../generators", __dir__))
+    end
+  end
+end

data/lib/nitro_kit/schema_builder.rb

@@ -0,0 +1,47 @@
+module NitroKit
+  module SchemaBuilder
+    Component = Struct.new(:files, :modules, :gems)
+
+    class Builder
+      def initialize
+        @schema = {}
+        yield self
+      end
+
+      def add(
+        name,
+        components: nil,
+        helpers: nil,
+        js: [],
+        modules: [],
+        gems: []
+      )
+        # Default is one component, one helper with same name
+        components ||= [name]
+        helpers ||= [name]
+
+        @schema[name] = Component.new(
+          [
+            components.map { |c| "app/components/nitro_kit/#{c}.rb" },
+            helpers.map { |c| "app/helpers/nitro_kit/#{c}_helper.rb" },
+            js.map { |c| "app/javascript/controllers/nk/#{c}_controller.js" }
+          ].flatten,
+          modules,
+          gems
+        )
+      end
+
+      def [](key)
+        @schema[key]
+      end
+
+      def all
+        @schema.keys.map(&:to_s)
+      end
+    end
+
+    def build_schema(&block)
+      Builder.new(&block)
+    end
+  end
+end

data/lib/nitro_kit/variants.rb

@@ -0,0 +1,21 @@
+module NitroKit
+  module Variants
+    module ClassMethods
+      def automatic_variants(variants, method_name)
+        _, prefix, original = method_name.match(/(nk_)(.+)/).to_a
+
+        variants.each do |variant, class_name|
+          variant_method_name = "#{prefix}#{variant}_#{original}"
+
+          define_method(variant_method_name) do |*args, **kwargs, &block|
+            send(method_name, *args, variant:, **kwargs, &block)
+          end
+        end
+      end
+    end
+
+    def self.included(base)
+      base.extend(ClassMethods)
+    end
+  end
+end

data/lib/nitro_kit/version.rb

@@ -0,0 +1,3 @@
+module NitroKit
+  VERSION = "0.1.0"
+end

data/lib/nitro_kit.rb

@@ -0,0 +1,8 @@
+require "tailwind_merge"
+require "phlex/rails"
+
+require "nitro_kit/variants"
+require "nitro_kit/railtie"
+
+module NitroKit
+end