hakumi_components 0.1.17.pre → 0.1.19.pre

data/app/components/hakumi/upload/component.rb

@@ -1,193 +0,0 @@
-# frozen_string_literal: true
-
-module Hakumi
-  module Upload
-    # Hakumi Upload component
-    # Provides file selection, drag-and-drop, and upload list management.
-    class Component < Hakumi::BaseComponent
-      LIST_TYPES = %i[text picture picture_card avatar].freeze
-
-      def initialize(
-        action:,
-        name:,
-        accept: nil,
-        multiple: false,
-        max_count: nil,
-        max_size: nil,
-        disabled: false,
-        list_type: :text,
-        show_upload_list: true,
-        drag: false,
-        headers: nil,
-        data: nil,
-        default_file_list: [],
-        with_credentials: false,
-        auto_upload: true,
-        inline_trigger: false,
-        avatar_shape: :circle,
-        avatar_size: 80,
-        avatar_icon: :user,
-        **html_options
-      )
-        @action = action
-        @name = name
-        @accept = accept
-        @multiple = multiple
-        @max_count = max_count
-        @max_size = max_size
-        @disabled = disabled
-        @list_type = list_type
-        @show_upload_list = show_upload_list
-        @drag = drag
-        @headers = headers
-        @data = data
-        @default_file_list = default_file_list
-        @with_credentials = with_credentials
-        @auto_upload = auto_upload
-        @inline_trigger = inline_trigger
-        @avatar_shape = avatar_shape
-        @avatar_size = avatar_size
-        @avatar_icon = avatar_icon
-        @html_options = html_options
-
-        validate_props!
-      end
-
-      def wrapper_classes
-        class_names(
-          "upload",
-          {
-            disabled: @disabled,
-            drag: @drag,
-            list: list_type_class
-          },
-          [ @html_options[:class] ]
-        )
-      end
-
-      def upload_list_classes
-        list_classes = [ "hakumi-upload-list", "hakumi-upload-list-#{list_type_class}" ]
-        list_classes << "hakumi-upload-list-empty" if normalized_file_list.empty?
-        list_classes.compact.join(" ")
-      end
-
-      def file_item_classes(file)
-        classes = [ "hakumi-upload-list-item", "hakumi-upload-list-item-#{file[:status] || 'done'}" ]
-        classes << "hakumi-upload-list-item-disabled" if @disabled
-        classes.join(" ")
-      end
-
-      def list_type_picture?
-        %i[picture picture_card].include?(@list_type)
-      end
-
-      def list_type_class
-        @list_type.to_s.tr("_", "-")
-      end
-
-      def progress_percent(file)
-        (file[:percent] || 0).to_i
-      end
-
-      def progress_style(file)
-        percent = progress_percent(file)
-        percent.positive? ? "--hakumi-upload-progress: #{percent}%" : nil
-      end
-
-      def normalized_file_list
-        Array(@default_file_list).map.with_index do |file, index|
-          hash = file.respond_to?(:to_h) ? file.to_h : { name: file.to_s }
-          hash = hash.symbolize_keys
-          hash[:uid] ||= "upload_#{index + 1}"
-          hash[:status] ||= "done"
-          hash
-        end
-      end
-
-      def action_label
-        content.presence || "Upload"
-      end
-
-      def stimulus_controller
-        "hakumi--upload"
-      end
-
-      def stimulus_values
-        {
-          action: @action,
-          name: @name,
-          accept: @accept,
-          multiple: @multiple,
-          maxCount: @max_count,
-          maxSize: @max_size,
-          disabled: @disabled,
-          listType: list_type_class,
-          showUploadList: @show_upload_list,
-          drag: @drag,
-          headers: @headers,
-          data: @data,
-          defaultFileList: normalized_file_list,
-          withCredentials: @with_credentials,
-          autoUpload: @auto_upload,
-          inlineTrigger: @inline_trigger,
-          avatarShape: @avatar_shape,
-          avatarSize: @avatar_size,
-          avatarIcon: @avatar_icon
-        }
-      end
-
-      def list_type_avatar?
-        @list_type == :avatar
-      end
-
-      def avatar_overlay_class
-        @avatar_shape == :circle ? "hakumi-upload-avatar-overlay--circle" : "hakumi-upload-avatar-overlay--square"
-      end
-
-      def inline_trigger?
-        @inline_trigger
-      end
-
-      def stimulus_data_attributes
-        stimulus_values.each_with_object({}) do |(key, value), attrs|
-          next if value.nil?
-
-          attrs["#{stimulus_controller}-#{key.to_s.underscore.dasherize}-value"] =
-            value.is_a?(Array) || value.is_a?(Hash) ? value.to_json : value
-        end
-      end
-
-      def wrapper_attributes
-        base_attrs = {
-          class: wrapper_classes,
-          data: {
-            controller: stimulus_controller
-          }.merge(stimulus_data_attributes)
-        }
-
-        merge_attributes(base_attrs, @html_options.except(:class))
-      end
-
-      def input_attributes
-        {
-          type: "file",
-          name: @name,
-          accept: @accept,
-          multiple: @multiple ? true : nil,
-          disabled: @disabled ? true : nil,
-          data: {
-            action: "change->hakumi--upload#handleInput",
-            hakumi__upload_target: "input"
-          }
-        }.compact
-      end
-
-      private
-
-      def validate_props!
-        validate_required!(:action, :name)
-        validate_inclusion!(:list_type, LIST_TYPES)
-      end
-    end
-  end
-end

data/app/form_builders/hakumi/form_builder.rb

@@ -1,482 +0,0 @@
-# frozen_string_literal: true
-
-module Hakumi
-  # Custom FormBuilder that renders Hakumi components for form inputs.
-  # Extends Rails' ActionView::Helpers::FormBuilder to integrate seamlessly with Rails forms.
-  # Includes automatic detection of validations, I18n labels, and attribute introspection.
-  #
-  # @example Usage
-  #   <%= hakumi_form_with(model: @user) do |f| %>
-  #     <%= f.text_field :email %>  # Automatically detects label, required, type, etc.
-  #     <%= f.password_field :password %>
-  #     <%= f.text_area :bio %>
-  #     <%= f.submit "Save" %>
-  #   <% end %>
-  class FormBuilder < ActionView::Helpers::FormBuilder
-    # Renders a Hakumi text input field with Rails integration
-    #
-    # @param method [Symbol] Name of the attribute
-    # @param options [Hash] Options for the input
-    # @return [String] Rendered HTML
-    def text_field(method, **options)
-      enhance_options_with_introspection!(method, options)
-      render_form_field(Hakumi::Input::Component, method, **options)
-    end
-
-    # Renders a Hakumi password input field with visibility toggle
-    #
-    # @param method [Symbol] Name of the attribute
-    # @param options [Hash] Options for the input
-    # @return [String] Rendered HTML
-    def password_field(method, **options)
-      enhance_options_with_introspection!(method, options)
-      render_form_field(Hakumi::Input::Password::Component, method, **options)
-    end
-
-    # Renders a Hakumi textarea field
-    #
-    # @param method [Symbol] Name of the attribute
-    # @param options [Hash] Options for the textarea
-    # @return [String] Rendered HTML
-    def text_area(method, **options)
-      enhance_options_with_introspection!(method, options)
-      render_form_field(Hakumi::Input::TextArea::Component, method, **options)
-    end
-
-    # Renders a Hakumi number input field
-    #
-    # @param method [Symbol] Name of the attribute
-    # @param options [Hash] Options for the input
-    # @return [String] Rendered HTML
-    def number_field(method, **options)
-      enhance_options_with_introspection!(method, options)
-      render_form_field(Hakumi::InputNumber::Component, method, **options)
-    end
-
-    # Renders a Hakumi select field
-    #
-    # @param method [Symbol] Name of the attribute
-    # @param choices [Array] Array of options [[label, value], ...]
-    # @param options [Hash] Options for the select
-    # @return [String] Rendered HTML
-    def select(method, choices = nil, **options)
-      choices ||= [] # steep:ignore UnannotatedEmptyCollection
-      enhance_options_with_introspection!(method, options)
-
-      render_form_field(
-        Hakumi::Select::Component,
-        method,
-        **options.merge(options: choices)
-      )
-    end
-
-    # Renders a Hakumi tree select field
-    #
-    # @param method [Symbol] Name of the attribute
-    # @param choices [Array] Array of tree options with keys: key, title, children
-    # @param options [Hash] Options for the tree select
-    # @return [String] Rendered HTML
-    def tree_select(method, choices = nil, **options)
-      choices ||= [] # steep:ignore UnannotatedEmptyCollection
-      enhance_options_with_introspection!(method, options)
-
-      render_form_field(
-        Hakumi::TreeSelect::Component,
-        method,
-        **options.merge(options: choices)
-      )
-    end
-
-    # Renders a Hakumi radio button
-    #
-    # @param method [Symbol] Name of the attribute
-    # @param tag_value [String] Value for this radio button
-    # @param options [Hash] Options for the radio
-    # @return [String] Rendered HTML
-    def radio_button(method, tag_value, **options)
-      enhance_options_with_introspection!(method, options)
-
-      # Use tag_value as ID suffix unless explicitly provided
-      id_suffix = options[:id] ? nil : tag_value.to_s
-      config = field_configuration(method, options, id_suffix: id_suffix)
-
-      # Override with explicit ID if provided
-      config[:id] = options.delete(:id) if options[:id]
-
-      # Determine if checked
-      checked = config[:value].to_s == tag_value.to_s
-      config[:value] = tag_value
-      config[:checked] = checked
-
-      render_form_field(
-        Hakumi::Radio::Component,
-        method,
-        config_overrides: config,
-        **options
-      )
-    end
-
-    # Renders a Hakumi radio group from a collection
-    #
-    # @param method [Symbol] Name of the attribute
-    # @param collection [Array] Collection of objects
-    # @param value_method [Symbol] Method to call for value
-    # @param text_method [Symbol] Method to call for label text
-    # @param options [Hash] Options for the radio group
-    # @return [String] Rendered HTML
-    def collection_radio_buttons(method, collection, value_method, text_method, **options)
-      enhance_options_with_introspection!(method, options)
-
-      # Convert collection to radio options format (Hash with :label and :value)
-      radio_options = collection.map do |item|
-        {
-          label: item.send(text_method),
-          value: item.send(value_method)
-        }
-      end
-
-      render_form_field(
-        Hakumi::Radio::Group::Component,
-        method,
-        **options.merge(options: radio_options)
-      )
-    end
-
-    # Renders a Hakumi switch (checkbox) field
-    #
-    # @param method [Symbol] Name of the attribute
-    # @param options [Hash] Options for the switch
-    # @return [String] Rendered HTML
-    def check_box(method, **options)
-      enhance_options_with_introspection!(method, options)
-
-      # Convert truthy/falsy value to boolean for checked attribute
-      value = object_value(method)
-      checked = value ? true : false
-
-      render_form_field(
-        Hakumi::Switch::Component,
-        method,
-        config_overrides: { checked: checked },
-        **options
-      )
-    end
-
-    # Renders a Hakumi rate (rating) field
-    #
-    # @param method [Symbol] Name of the attribute
-    # @param options [Hash] Options for the rate component
-    # @return [String] Rendered HTML
-    def rate_field(method, **options)
-      enhance_options_with_introspection!(method, options)
-      render_form_field(Hakumi::Rate::Component, method, **options)
-    end
-
-    # Renders a Hakumi slider field
-    #
-    # @param method [Symbol] Name of the attribute
-    # @param options [Hash] Options for the slider component
-    # @return [String] Rendered HTML
-    def slider_field(method, **options)
-      enhance_options_with_introspection!(method, options)
-
-      config = field_configuration(method, options)
-
-      render_form_field(
-        Hakumi::Slider::Component,
-        method,
-        config_overrides: config,
-        **options
-      )
-    end
-
-    # Renders a Hakumi date picker field
-    #
-    # @param method [Symbol] Name of the attribute
-    # @param options [Hash] Options for the date picker
-    # @return [String] Rendered HTML
-    def date_picker(method, **options)
-      enhance_options_with_introspection!(method, options)
-      render_form_field(Hakumi::DatePicker::Component, method, **options)
-    end
-
-    # Renders a Hakumi mentions field (textarea with @ mention suggestions)
-    #
-    # @param method [Symbol] Name of the attribute
-    # @param options [Hash] Options for the mentions component
-    # @option options [Array] :options Array of mention options (names, usernames, etc.)
-    # @option options [String, Array] :prefix Character(s) that trigger mentions (default: "@")
-    # @option options [String] :split Character that separates tokens (default: " ")
-    # @option options [Symbol] :filter_option Filter mode (:contains, :starts_with)
-    # @return [String] Rendered HTML
-    def mentions_field(method, **options)
-      enhance_options_with_introspection!(method, options)
-
-      # Extract mentions-specific options before field configuration
-      mention_options = options.delete(:options) || []
-
-      render_form_field(
-        Hakumi::Mentions::Component,
-        method,
-        **options.merge(options: mention_options)
-      )
-    end
-
-    # Renders a Hakumi autocomplete field (input with dropdown suggestions)
-    #
-    # @param method [Symbol] Name of the attribute
-    # @param choices [Array] Array of autocomplete options
-    # @param options [Hash] Options for the autocomplete component
-    # @return [String] Rendered HTML
-    def autocomplete_field(method, choices = nil, **options)
-      choices ||= [] # steep:ignore UnannotatedEmptyCollection
-      enhance_options_with_introspection!(method, options)
-
-      render_form_field(
-        Hakumi::Autocomplete::Component,
-        method,
-        **options.merge(options: choices)
-      )
-    end
-
-    # Renders a Hakumi cascader field (cascading dropdown selector)
-    #
-    # @param method [Symbol] Name of the attribute
-    # @param choices [Array] Array of cascader options with children
-    # @param options [Hash] Options for the cascader component
-    # @return [String] Rendered HTML
-    def cascader_field(method, choices = nil, **options)
-      choices ||= [] # steep:ignore UnannotatedEmptyCollection
-      enhance_options_with_introspection!(method, options)
-
-      render_form_field(
-        Hakumi::Cascader::Component,
-        method,
-        **options.merge(options: choices)
-      )
-    end
-
-    # Renders a Hakumi checkbox field (traditional checkbox, different from switch)
-    #
-    # @param method [Symbol] Name of the attribute
-    # @param options [Hash] Options for the checkbox
-    # @return [String] Rendered HTML
-    def checkbox_field(method, **options)
-      enhance_options_with_introspection!(method, options)
-
-      # Convert truthy/falsy value to boolean for checked attribute
-      value = object_value(method)
-      checked = value ? true : false
-
-      render_form_field(
-        Hakumi::Checkbox::Component,
-        method,
-        config_overrides: { checked: checked },
-        **options
-      )
-    end
-
-    # Renders a Hakumi color picker field
-    #
-    # @param method [Symbol] Name of the attribute
-    # @param options [Hash] Options for the color picker component
-    # @return [String] Rendered HTML
-    def color_picker_field(method, **options)
-      enhance_options_with_introspection!(method, options)
-      render_form_field(Hakumi::ColorPicker::Component, method, **options)
-    end
-
-    # Renders a Hakumi time picker field
-    #
-    # @param method [Symbol] Name of the attribute
-    # @param options [Hash] Options for the time picker component
-    # @return [String] Rendered HTML
-    def time_picker_field(method, **options)
-      enhance_options_with_introspection!(method, options)
-      render_form_field(Hakumi::TimePicker::Component, method, **options)
-    end
-
-    # Renders a Hakumi transfer field (dual list box)
-    #
-    # @param method [Symbol] Name of the attribute
-    # @param data_source [Array] Array of items to transfer
-    # @param options [Hash] Options for the transfer component
-    # @return [String] Rendered HTML
-    def transfer_field(method, data_source = nil, **options)
-      data_source ||= [] # steep:ignore UnannotatedEmptyCollection
-      enhance_options_with_introspection!(method, options)
-
-      render_form_field(
-        Hakumi::Transfer::Component,
-        method,
-        **options.merge(data_source: data_source)
-      )
-    end
-
-    # Renders a Hakumi upload field (file upload)
-    #
-    # @param method [Symbol] Name of the attribute
-    # @param options [Hash] Options for the upload component
-    # @option options [String] :action Upload URL (required)
-    # @return [String] Rendered HTML
-    def upload_field(method, **options)
-      enhance_options_with_introspection!(method, options)
-
-      # Upload requires action parameter
-      raise ArgumentError, "action parameter is required for upload_field" unless options[:action]
-
-      render_form_field(Hakumi::Upload::Component, method, **options)
-    end
-
-    # Renders a Hakumi submit button
-    #
-    # @param value [String] Button text (defaults to "Save")
-    # @param options [Hash] Options for the button
-    # @return [String] Rendered HTML
-    def submit(value = nil, **options)
-      value ||= submit_default_value
-
-      # Extract Hakumi-specific options
-      button_type = options.delete(:type) || :primary
-      button_size = options.delete(:size) || :middle
-      block = options.delete(:block) || false
-      loading = options.delete(:loading) || false
-      danger = options.delete(:danger) || false
-
-      @template.render(Hakumi::Button::Component.new(
-        type: button_type,
-        size: button_size,
-        html_type: :submit,
-        block: block,
-        loading: loading,
-        danger: danger,
-        **options
-      )) { value }
-    end
-
-    private
-
-    # Gets standard field configuration (name, id, value, errors)
-    #
-    # @param method [Symbol] Attribute name
-    # @param options [Hash] Options hash (modifies in place by deleting :value)
-    # @param id_suffix [String, nil] Optional suffix for field_id (for radio buttons)
-    # @return [Hash] Field configuration with :name, :id, :value, :errors
-    def field_configuration(method, options, id_suffix: nil)
-      field_name = @object_name ? "#{@object_name}[#{method}]" : method.to_s
-
-      base_id = @object_name ? "#{@object_name}_#{method}" : method.to_s
-      field_id = id_suffix ? "#{base_id}_#{id_suffix}".parameterize.underscore : base_id
-
-      value = options.delete(:value) || object_value(method)
-      errors = object_errors(method)
-
-      {
-        name: field_name,
-        id: field_id,
-        value: value,
-        errors: errors
-      }
-    end
-
-    # Enhances options hash with automatic detection from Rails validations and I18n
-    #
-    # @param method [Symbol] Attribute name
-    # @param options [Hash] Options hash to enhance
-    # @return [Hash] Enhanced options
-    def enhance_options_with_introspection!(method, options)
-      return unless @object
-
-      # Auto-detect label from I18n (if not provided)
-      if options[:label].nil?
-        detected_label = Hakumi::Rails::AttributeIntrospection.human_attribute_name(@object, method)
-        options[:label] = detected_label if detected_label
-      end
-
-      # Auto-detect required for UI purposes (asterisk display) - NOT for HTML5 validation
-      if options[:required].nil?
-        options[:required] = Hakumi::Rails::ValidationIntrospection.required?(@object, method)
-      end
-
-      # Auto-detect placeholder from I18n (if not provided)
-      if options[:placeholder].nil?
-        detected_placeholder = Hakumi::Rails::AttributeIntrospection.placeholder(@object, method)
-        options[:placeholder] = detected_placeholder if detected_placeholder
-      end
-
-      # Auto-detect caption (hint) from I18n (if not provided)
-      if options[:caption].nil?
-        detected_hint = Hakumi::Rails::AttributeIntrospection.hint(@object, method)
-        options[:caption] = detected_hint if detected_hint
-      end
-
-      # Auto-generate frontend validation rules from Rails validations
-      # If manual rules are provided, merge them with auto-detected rules
-      # Manual rules take priority over auto-detected ones for the same validation type
-      detected_rules = Hakumi::Rails::ValidationMapper.to_frontend_rules(@object, method)
-      manual_rules = options[:rules]
-
-      if manual_rules.nil?
-        options[:rules] = detected_rules unless detected_rules.empty?
-      elsif !detected_rules.empty?
-        # Merge manual and auto-detected rules, with manual rules taking priority
-        options[:rules] = Hakumi::Rails::ValidationMapper.merge_rules(manual_rules, detected_rules)
-      end
-      # If manual_rules is present but detected_rules is empty, keep manual_rules as-is
-
-      # Auto-detect input type based on attribute name and validations (if not provided)
-      if options[:type].nil?
-        if Hakumi::Rails::ValidationIntrospection.email_field?(@object, method)
-          options[:type] = :email
-        elsif Hakumi::Rails::ValidationIntrospection.url_field?(@object, method)
-          options[:type] = :url
-        else
-          # Fallback to column type
-          detected_type = Hakumi::Rails::AttributeIntrospection.input_type_from_column(@object, method)
-          options[:type] = detected_type if detected_type && detected_type != :text
-        end
-      end
-
-      options
-    end
-
-    # Renders a form field component with Rails integration
-    #
-    # @param component_class [Class] Component class to render
-    # @param method [Symbol] Name of the attribute
-    # @param options [Hash] Options for the component
-    # @param config_overrides [Hash] Override field configuration (for special cases)
-    # @return [String] Rendered HTML
-    def render_form_field(component_class, method, config_overrides: {}, **options)
-      config = field_configuration(method, options)
-      config.merge!(config_overrides)
-
-      # Merge all options with standalone: false
-      component_options = config.merge(options).merge(standalone: false)
-
-      # Render the component with merged configuration
-      @template.render(component_class.new(**component_options))
-    end
-
-    # Gets the current value of an attribute from the object
-    #
-    # @param method [Symbol] Attribute name
-    # @return [Object] Current value
-    def object_value(method)
-      @object.respond_to?(method) ? @object.public_send(method) : nil
-    end
-
-    # Gets validation errors for an attribute from the object
-    # Uses full_messages_for to include attribute name in error messages
-    #
-    # @param method [Symbol] Attribute name
-    # @return [Array<String>] Array of error messages
-    def object_errors(method)
-      return [] unless @object.respond_to?(:errors)
-
-      # Use full_messages_for which includes the attribute name
-      # e.g., "Email can't be blank" instead of "can't be blank"
-      @object.errors.full_messages_for(method)
-    end
-  end
-end

data/app/helpers/hakumi/form_helper.rb

@@ -1,39 +0,0 @@
-# frozen_string_literal: true
-
-module Hakumi
-  module FormHelper
-    # Creates a form that uses Hakumi components.
-    # This is a wrapper around Rails' form_with that automatically sets the Hakumi::FormBuilder.
-    #
-    # @example Basic usage
-    #   <%= hakumi_form_with(model: @user) do |f| %>
-    #     <%= f.text_field :name, label: "Name" %>
-    #     <%= f.submit "Save" %>
-    #   <% end %>
-    #
-    # @example With URL
-    #   <%= hakumi_form_with(url: "/users", method: :post) do |f| %>
-    #     <%= f.text_field :email, label: "Email" %>
-    #   <% end %>
-    #
-    # @param options [Hash] Options to pass to form_with
-    # @option options [Object] :model Model object for the form
-    # @option options [String] :url URL to submit the form to
-    # @option options [Symbol] :method HTTP method (:get, :post, :patch, :delete)
-    # @option options [Class] :builder Custom form builder (defaults to Hakumi::FormBuilder)
-    # @option options [Symbol] :layout Form layout (:horizontal, :vertical, :inline)
-    # @return [String] HTML form
-    def hakumi_form_with(**options, &block)
-      options[:builder] ||= Hakumi::FormBuilder
-
-      layout = options.delete(:layout)
-      if layout
-        html_options = options[:html] || {}
-        html_options[:class] = class_names(html_options[:class], "hakumi-form", "hakumi-form-#{layout}")
-        options[:html] = html_options
-      end
-
-      form_with(**options, &block)
-    end
-  end
-end