hakumi_components 0.1.17.pre → 0.1.19.pre

data/app/services/hakumi/component_handler.rb

@@ -1,53 +0,0 @@
-# frozen_string_literal: true
-
-module Hakumi
-  class ComponentHandler
-    def initialize(component, params)
-      @component = component.to_sym
-      @params = params
-    end
-
-    def locals
-      base_locals.merge(specific_locals)
-    end
-
-    private
-
-    def base_locals
-      {
-        id: @params[:id].presence || "hakumi-#{@component}-#{SecureRandom.hex(4)}"
-      }
-    end
-
-    def specific_locals
-      component_class = resolve_component_class
-      return {} unless component_class.respond_to?(:extract_controller_locals)
-
-      component_class.extract_controller_locals(@params)
-    end
-
-    def resolve_component_class
-      case @component
-      when :modal then Hakumi::Modal::Component
-      when :confirm then Hakumi::Modal::Confirm::Component
-      when :alert then Hakumi::Alert::Component
-      when :drawer then Hakumi::Drawer::Component
-      when :message then Hakumi::Message::Component
-      when :notification then Hakumi::Notification::Component
-      when :popover then Hakumi::Popover::Component
-      when :progress then Hakumi::Progress::Component
-      when :result then Hakumi::Result::Component
-      when :skeleton then Hakumi::Skeleton::Component
-      when :spin then Hakumi::Spin::Component
-      when :qr_code then Hakumi::QrCode::Component
-      when :affix then Hakumi::Affix::Component
-      when :segmented then Hakumi::Segmented::Component
-      when :statistic then Hakumi::Statistic::Component
-      when :tag then Hakumi::Tag::Component
-      when :timeline then Hakumi::Timeline::Component
-      when :tree then Hakumi::Tree::Component
-      else nil
-      end
-    end
-  end
-end

data/app/services/hakumi/icon/loader.rb

@@ -1,95 +0,0 @@
-# frozen_string_literal: true
-
-module Hakumi
-  module Icon
-    # Loads Ant Design icons from lib/hakumi_components/app/assets/icons
-    class Loader
-      ICONS_BASE_PATH = if defined?(Hakumi::Engine)
-        Hakumi::Engine.root.join("app", "assets", "icons")
-      else
-        Rails.root.join("app", "assets", "icons")
-      end
-
-      class << self
-        def cache
-          @cache ||= {}
-        end
-
-        def load(name, theme = :outlined)
-          cache_key = "#{name}_#{theme}"
-          return cache[cache_key] if cache.key?(cache_key)
-
-          svg = read_icon_file(name, theme)
-          cache[cache_key] = svg
-          svg
-        end
-
-        def exists?(name, theme = :outlined)
-          !load(name, theme).nil?
-        end
-
-        def list_icons(theme = :outlined)
-          theme_dir = theme_directory(theme)
-          return [] unless theme_dir.exist?
-
-          Dir.glob(theme_dir.join("*.svg")).map do |path|
-            File.basename(path, ".svg").gsub("-", "_")
-          end.sort
-        end
-
-        def clear_cache!
-          @cache = {}
-        end
-
-        private
-
-        def read_icon_file(name, theme)
-          filepath = icon_filepath(name, theme)
-          return nil unless filepath.exist?
-
-          svg_content = File.read(filepath)
-          enhance_svg(svg_content)
-        rescue => e
-          Rails.logger.error("Error loading icon #{name} (#{theme}): #{e.message}")
-          nil
-        end
-
-        def icon_filepath(name, theme)
-          theme_dir = theme_directory(theme)
-          filename = kebabize(name.to_s)
-          theme_dir.join("#{filename}.svg")
-        end
-
-        def theme_directory(theme)
-          theme_str = case theme.to_sym
-          when :outlined then "outlined"
-          when :filled then "filled"
-          when :two_tone, :twotone then "twotone"
-          else "outlined"
-          end
-
-          ICONS_BASE_PATH.join(theme_str)
-        end
-
-        def enhance_svg(svg_content)
-          svg = svg_content.dup
-
-          svg.sub!("<svg", '<svg width="1em"') unless svg.include?("width=")
-          svg.sub!("<svg", '<svg height="1em"') unless svg.include?("height=")
-          svg.sub!("<svg", '<svg fill="currentColor"') unless svg.include?("fill=")
-
-          svg
-        end
-
-        def kebabize(str)
-          str.gsub(/::/, "/")
-             .gsub(/([A-Z]+)([A-Z][a-z])/, '\1-\2')
-             .gsub(/([a-z\d])([A-Z])/, '\1-\2')
-             .tr("_", "-")
-             .downcase
-        end
-      end
-    end
-  end
-end
-HakumiIconLoader = Hakumi::Icon::Loader unless defined?(HakumiIconLoader)

data/app/services/hakumi/illustrations/loader.rb

@@ -1,43 +0,0 @@
-# frozen_string_literal: true
-
-module Hakumi
-  module Illustrations
-    # Loads SVG illustrations stored under lib/hakumi_components/app/assets/illustrations
-    class Loader
-      ILLUSTRATIONS_PATH = if defined?(Hakumi::Engine)
-        Hakumi::Engine.root.join("app", "assets", "illustrations")
-      else
-        Rails.root.join("lib", "hakumi_components", "app", "assets", "illustrations")
-      end
-
-      class << self
-        def load(name)
-          filename = "#{name}.svg"
-          cache[filename] ||= read_svg(filename)
-        end
-
-        def clear_cache!
-          @cache = {}
-        end
-
-        private
-
-        def cache
-          @cache ||= {}
-        end
-
-        def read_svg(filename)
-          path = ILLUSTRATIONS_PATH.join(filename)
-          return nil unless path.exist?
-
-          svg = File.read(path)
-          svg.respond_to?(:html_safe) ? svg.html_safe : svg
-        rescue => e
-          ::Rails.logger.error("Error loading illustration #{filename}: #{e.message}")
-          nil
-        end
-      end
-    end
-  end
-end
-HakumiIllustrationLoader = Hakumi::Illustrations::Loader unless defined?(HakumiIllustrationLoader)

data/sig/action_view/tag_builder.rbs

@@ -1,24 +0,0 @@
-# frozen_string_literal: true
-
-module ActionView
-  module Helpers
-    class TagBuilder
-      def method_missing: (Symbol name, *Object args, **hakumi_html_options) -> String
-    end
-
-    module TagHelper
-      def tag: () -> TagBuilder
-      def content_tag: (Symbol tag_name, String? content, **Object attributes) -> String
-      def content_tag: (Symbol tag_name, **Object attributes) { () -> String? } -> String
-      def safe_join: (Array[Object] array, ?String separator) -> String
-    end
-
-    module AssetTagHelper
-      def image_tag: (String src, **Object options) -> String
-    end
-
-    module CaptureHelper
-      def capture: () { () -> String } -> String
-    end
-  end
-end

data/sig/active_support/concern_patch.rbs

@@ -1,7 +0,0 @@
-# frozen_string_literal: true
-
-module ActiveSupport
-  module Concern
-    def included: (?Module base) { () -> void } -> void
-  end
-end

data/sig/generators/hakumi/install_generator.rbs

@@ -1,11 +0,0 @@
-# frozen_string_literal: true
-
-module Hakumi
-  class InstallGenerator < Rails::Generators::Base
-    def add_npm_package: () -> void
-    def setup_javascript: () -> void
-    def setup_stylesheets: () -> void
-    def setup_form_builder: () -> void
-    def show_post_install: () -> void
-  end
-end

data/sig/hakumi/admin_panel/component.rbs

@@ -1,28 +0,0 @@
-# frozen_string_literal: true
-
-module Hakumi
-  module AdminPanel
-    class Component < Hakumi::BaseComponent
-      # Extracts locals from controller params for dynamic rendering
-      def self.extract_controller_locals: (untyped params) -> Hash[Symbol, untyped]
-
-      @title: String
-      @enabled: bool
-      @html_options: hakumi_html_options
-
-      def initialize: (
-        ?title: String,
-        ?enabled: bool,
-        **hakumi_html_options html_options
-      ) -> void
-
-      def render?: () -> bool
-
-      private
-
-      attr_reader title: String
-
-      def wrapper_attributes: () -> hakumi_html_options
-    end
-  end
-end

data/sig/hakumi/affix/component.rbs

@@ -1,44 +0,0 @@
-# frozen_string_literal: true
-
-module Hakumi
-  module Affix
-    class Component < Hakumi::BaseComponent
-      # Extracts locals from controller params for dynamic rendering
-      def self.extract_controller_locals: (untyped params) -> Hash[Symbol, untyped]
-
-      @body: String?
-      @offset_top: Float?
-      @offset_bottom: Float?
-      @target_selector: String?
-      @z_index: Integer?
-      @on_change: String?
-      @html_options: hakumi_html_options
-
-      def initialize: (
-        ?body: String?,
-        ?offset_top: (Float | Integer | String)?,
-        ?offset_bottom: (Float | Integer | String)?,
-        ?target_selector: String?,
-        ?z_index: (Integer | String)?,
-        ?on_change: String?,
-        **hakumi_html_options html_options
-      ) -> void
-
-      def root_attributes: () -> hakumi_html_options
-
-      def content_value: () -> String?
-
-      private
-
-      def data_attributes: () -> hakumi_data_attributes
-
-      def normalize_numeric: ((Float | Integer | String)? value) -> (Float | Integer)?
-
-      def normalize_offsets!: () -> void
-
-      def validate_props!: () -> void
-
-      def append_action: (String? existing, String action) -> String
-    end
-  end
-end

data/sig/hakumi/alert/component.rbs

@@ -1,64 +0,0 @@
-# frozen_string_literal: true
-
-module Hakumi
-  module Alert
-    class Component < Hakumi::BaseComponent
-      type alert_type = :success | :info | :warning | :error
-
-      TYPES: Array[alert_type]
-
-      # Extracts locals from controller params for dynamic rendering
-      def self.extract_controller_locals: (untyped params) -> Hash[Symbol, untyped]
-
-      @type: alert_type
-      @message: String?
-      @description: String?
-      @show_icon: bool
-      @icon: hakumi_icon?
-      @closable: bool
-      @close_text: String?
-      @banner: bool
-      @action: untyped
-      @html_options: hakumi_html_options
-
-      def initialize: (
-        ?type: alert_type?,
-        ?message: String?,
-        ?description: String?,
-        ?show_icon: bool?,
-        ?icon: hakumi_icon?,
-        ?closable: bool,
-        ?close_text: String?,
-        ?banner: bool,
-        ?action: untyped,
-        **hakumi_html_options html_options
-      ) -> void
-
-      private
-
-      def validate_props!: () -> void
-
-      def wrapper_classes: () -> String
-
-      def wrapper_attributes: () -> hakumi_html_options
-
-      def message_content: () -> String?
-
-      def description_present?: () -> bool
-
-      def description_content: () -> String?
-
-      def action_present?: () -> bool
-
-      def action_content: () -> String?
-
-      def show_icon?: () -> bool
-
-      def icon_element: () -> String?
-
-      def default_icon: () -> Symbol
-
-      def close_button_classes: () -> String
-    end
-  end
-end

data/sig/hakumi/anchor/component.rbs

@@ -1,45 +0,0 @@
-# frozen_string_literal: true
-
-module Hakumi
-  module Anchor
-    class Component < Hakumi::BaseComponent
-      type anchor_direction = :vertical | :horizontal
-
-      DIRECTIONS: Array[anchor_direction]
-
-      @affix: bool
-      @bounds: (Integer | Float)
-      @offset_top: (Integer | Float)
-      @target_offset: (Integer | Float)?
-      @direction: anchor_direction
-      @replace: bool
-      @html_options: hakumi_html_options
-
-      def initialize: (
-        ?affix: bool,
-        ?bounds: (Integer | Float),
-        ?offset_top: (Integer | Float),
-        ?target_offset: (Integer | Float)?,
-        ?direction: anchor_direction,
-        ?replace: bool,
-        **hakumi_html_options html_options
-      ) -> void
-
-      def wrapper_classes: () -> String
-
-      def anchor_classes: () -> String
-
-      def stimulus_controller: () -> String
-
-      def stimulus_values: () -> Hash[Symbol, untyped]
-
-      def wrapper_attributes: () -> hakumi_html_options
-
-      def horizontal?: () -> bool
-
-      private
-
-      def validate_props!: () -> void
-    end
-  end
-end

data/sig/hakumi/anchor/link/component.rbs

@@ -1,31 +0,0 @@
-# frozen_string_literal: true
-
-module Hakumi
-  module Anchor
-    module Link
-      class Component < Hakumi::BaseComponent
-        @href: String
-        @title: String
-        @target: String?
-        @html_options: hakumi_html_options
-
-        def initialize: (
-          href: String,
-          title: String,
-          ?target: String?,
-          **hakumi_html_options html_options
-        ) -> void
-
-        attr_reader href: String
-        attr_reader title: String
-        attr_reader target: String?
-
-        def link_classes: () -> String
-
-        def title_classes: () -> String
-
-        def has_children?: () -> bool
-      end
-    end
-  end
-end

data/sig/hakumi/autocomplete/component.rbs

@@ -1,68 +0,0 @@
-# frozen_string_literal: true
-
-module Hakumi
-  module Autocomplete
-    class Component < Hakumi::BaseComponent
-      type autocomplete_variant = :outlined | :filled | :borderless | :underlined
-      type autocomplete_status = :error | :warning
-      type filter_mode = :contains | :starts_with
-
-      SIZES: Array[hakumi_size_standard]
-      VARIANTS: Array[autocomplete_variant]
-      STATUSES: Array[autocomplete_status]
-      FILTER_MODES: Array[filter_mode]
-
-      @name: String
-      @options: Array[untyped]
-      @value: String?
-      @placeholder: String?
-      @size: hakumi_size_standard
-      @variant: autocomplete_variant
-      @status: autocomplete_status?
-      @disabled: bool
-      @allow_clear: bool
-      @clear_icon: hakumi_icon
-      @input_renderer: Proc?
-      @case_sensitive: bool
-      @filter_mode: filter_mode
-      @not_found_content: String
-      @html_options: hakumi_html_options
-
-      def initialize: (
-        name: String,
-        ?options: Array[untyped],
-        ?value: String?,
-        ?placeholder: String?,
-        ?size: hakumi_size_standard,
-        ?variant: autocomplete_variant,
-        ?status: autocomplete_status?,
-        ?disabled: bool,
-        ?allow_clear: bool,
-        ?clear_icon: hakumi_icon,
-        ?input_renderer: Proc?,
-        ?case_sensitive: bool,
-        ?filter_mode: filter_mode,
-        ?not_found_content: String,
-        **hakumi_html_options html_options
-      ) -> void
-
-      private
-
-      def validate_props!: () -> void
-      def wrapper_classes: () -> String
-      def wrapper_attributes: () -> hakumi_html_options
-      def input_attributes: () -> hakumi_html_options
-      def input_classes: () -> String
-      def dropdown_id: () -> String
-      def allow_clear?: () -> bool
-      def custom_input_renderer?: () -> bool
-      def input_renderer: () -> Proc?
-      def disabled?: () -> bool
-      def clear_icon: () -> hakumi_icon
-      def not_found_content: () -> String
-      def normalized_items: () -> Array[Hash[Symbol, untyped]]
-      def normalize_group_options: (Array[untyped] options) -> Array[Hash[Symbol, untyped]]
-      def normalize_simple_option: (untyped opt) -> Hash[Symbol, untyped]?
-    end
-  end
-end

data/sig/hakumi/avatar/component.rbs

@@ -1,44 +0,0 @@
-# frozen_string_literal: true
-
-module Hakumi
-  module Avatar
-    class Component < Hakumi::BaseComponent
-      type avatar_shape = :circle | :square
-      type avatar_size = :small | :default | :large
-
-      SHAPES: Array[avatar_shape]
-      SIZES: Array[avatar_size]
-
-      @shape: avatar_shape
-      @size: (avatar_size | Integer)
-      @src: String?
-      @icon: hakumi_icon?
-      @alt: String?
-      @html_options: hakumi_html_options
-
-      def initialize: (
-        ?shape: avatar_shape,
-        ?size: (avatar_size | Integer),
-        ?src: String?,
-        ?icon: hakumi_icon?,
-        ?alt: String?,
-        **hakumi_html_options html_options
-      ) -> void
-
-      def call: () -> String
-
-      private
-
-      def validate_props!: () -> void
-
-      def wrapper_classes: () -> String
-
-      def content_wrapper: () -> String
-
-      # Type assertion: case statement always returns Integer despite @size being (avatar_size | Integer)
-      def avatar_size: () -> (avatar_size | Integer)
-
-      def wrapper_attributes: () -> hakumi_html_options
-    end
-  end
-end

data/sig/hakumi/badge/component.rbs

@@ -1,41 +0,0 @@
-# frozen_string_literal: true
-
-module Hakumi
-  module Badge
-    class Component < Hakumi::BaseComponent
-      type badge_status = :success | :processing | :default | :error | :warning
-
-      @count: (Integer | String)?
-      @dot: bool
-      @overflow_count: Integer
-      @status: badge_status?
-      @text: String?
-      @color: hakumi_color?
-      @show_zero: bool
-      @icon: hakumi_icon?
-      @html_options: hakumi_html_options
-
-      def initialize: (
-        ?count: (Integer | String)?,
-        ?dot: bool,
-        ?overflow_count: Integer,
-        ?status: badge_status?,
-        ?text: String?,
-        ?color: hakumi_color?,
-        ?show_zero: bool,
-        ?icon: hakumi_icon?,
-        **hakumi_html_options html_options
-      ) -> void
-
-      def call: () -> String
-
-      private
-
-      def badge_element: () -> String?
-
-      def status_text_element: () -> String?
-
-      def display_count: () -> (Integer | String | nil)
-    end
-  end
-end

data/sig/hakumi/base_component.rbs

@@ -1,82 +0,0 @@
-# frozen_string_literal: true
-
-module Hakumi
-  class BaseComponent < ViewComponent::Base
-    # Core class methods
-    def self.inherited: (Class klass) -> void
-
-    # Instance methods
-    # Generate class names with the hakumi- prefix
-    # @param base [String] Base class name (e.g., 'btn', 'icon')
-    # @param modifiers [Hash] Hash of modifier keys and their values (Symbol, String, Integer, or bool)
-    # @param extras [Array<String>] Additional classes to append
-    # @return [String] Combined class string
-    def class_names: (String base, ?Hash[Symbol, (Symbol | String | Integer | bool)] modifiers, ?Array[String] extras) -> String
-
-    # Merge HTML attributes with defaults
-    # @param defaults [Hash] Default attributes
-    # @param overrides [Hash] User-provided attributes
-    # @return [Hash] Merged attributes
-    def merge_attributes: (hakumi_html_options defaults, hakumi_html_options overrides) -> hakumi_html_options
-
-    # Internal helper to check presence without clobbering ActiveSupport#present?
-    # Accepts any value type since it's a generic utility method
-    # @param value [untyped] Value to check
-    # @return [Boolean]
-    def value_present?: (untyped value) -> bool
-
-    # Validate required props
-    # @param props [Array<Symbol>] List of required prop names
-    # @raise [ArgumentError] if any prop is missing
-    def validate_required!: (*Symbol props) -> void
-
-    # Validate prop is one of allowed values
-    # @param prop [Symbol] Prop name
-    # @param allowed [Array] Allowed values (typically Symbol enums, but can include strings/integers)
-    # @raise [ArgumentError] if value is not allowed
-    def validate_inclusion!: (Symbol prop, Array[Symbol | String | Integer | bool] allowed) -> void
-
-    # Ensure attrs has a DOM ID if it has a Stimulus controller
-    # @param attrs [Hash] Attributes hash
-    # @return [void]
-    def ensure_dom_id!: (hakumi_html_options attrs) -> void
-
-    # Generate a unique ID with a prefix
-    # @param prefix [String] Prefix for the ID
-    # @param length [Integer] Length of the random hex (default: 4)
-    # @return [String] Generated ID
-    def generate_id: (String prefix, ?length: Integer) -> String
-
-    # Render a value that can be a String, ViewComponent, or other renderable object
-    # Accepts: String, ActiveSupport::SafeBuffer, ViewComponent, or any object with to_s
-    # @param value [untyped] Value to render (String, ViewComponent, etc.)
-    # @return [String, nil] Rendered value or nil if empty
-    def render_value: (untyped value) -> (String | nil)
-
-    # Convert size string/symbol to integer pixels
-    # Useful for components that accept both symbolic (:small, :large) and numeric sizes
-    # @param size [Symbol, Integer] Size value
-    # @param mapping [Hash] Size to pixel mapping
-    # @return [Integer] Size in pixels
-    def size_to_pixels: ((Symbol | Integer) size, ?Hash[Symbol, Integer] mapping) -> Integer
-
-    # Convert dimension value to CSS string
-    # @param value [Numeric, String, nil] Dimension value
-    # @return [String, nil] CSS dimension string
-    def dimension_to_css: ((Numeric | String | nil) value) -> String?
-
-    # Cast a value to boolean using ActiveModel::Type::Boolean
-    # @param value [untyped] Value to cast
-    # @return [Boolean] Casted boolean value
-    def cast_boolean: (untyped value) -> bool
-
-    # Build inline style string from array or hash
-    # @param styles [Array<String>, Hash] Styles as array of CSS strings or hash of property => value
-    # @return [String, nil] Combined style string
-    def build_inline_style: ((Array[String] | Hash[Symbol | String, (String | Integer | Float)]) styles) -> String?
-
-    private
-
-    def prepare_data_attributes: (hakumi_html_options attrs) -> hakumi_html_options
-  end
-end