hakumi_components 0.1.18.pre → 0.1.19.pre

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

@@ -1,31 +0,0 @@
-# frozen_string_literal: true
-
-module HakumiComponents
-  module Anchor
-    module Link
-      class Component < HakumiComponents::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_components/autocomplete/component.rbs

@@ -1,68 +0,0 @@
-# frozen_string_literal: true
-
-module HakumiComponents
-  module Autocomplete
-    class Component < HakumiComponents::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_components/avatar/component.rbs

@@ -1,44 +0,0 @@
-# frozen_string_literal: true
-
-module HakumiComponents
-  module Avatar
-    class Component < HakumiComponents::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_components/badge/component.rbs

@@ -1,41 +0,0 @@
-# frozen_string_literal: true
-
-module HakumiComponents
-  module Badge
-    class Component < HakumiComponents::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_components/base_component.rbs

@@ -1,82 +0,0 @@
-# frozen_string_literal: true
-
-module HakumiComponents
-  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

data/sig/hakumi_components/breadcrumb/component.rbs

@@ -1,21 +0,0 @@
-# frozen_string_literal: true
-
-module HakumiComponents
-  module Breadcrumb
-    class Component < HakumiComponents::BaseComponent
-      @separator: String
-      @html_options: hakumi_html_options
-
-      def initialize: (
-        ?separator: String,
-        **hakumi_html_options html_options
-      ) -> void
-
-      attr_reader separator: String
-
-      def breadcrumb_classes: () -> String
-
-      def wrapper_attributes: () -> hakumi_html_options
-    end
-  end
-end

data/sig/hakumi_components/breadcrumb/item/component.rbs

@@ -1,36 +0,0 @@
-# frozen_string_literal: true
-
-module HakumiComponents
-  module Breadcrumb
-    module Item
-      class Component < HakumiComponents::BaseComponent
-        @title: String?
-        @href: String?
-        @target: String?
-        @menu: Array[untyped]?
-        @html_options: hakumi_html_options
-
-        def initialize: (
-          ?title: String?,
-          ?href: String?,
-          ?target: String?,
-          ?menu: Array[untyped]?,
-          **hakumi_html_options html_options
-        ) -> void
-
-        attr_reader title: String?
-        attr_reader href: String?
-        attr_reader target: String?
-        attr_reader menu: Array[untyped]?
-
-        def item_classes: () -> String
-
-        def link?: () -> bool
-
-        def menu?: () -> bool
-
-        def display_title: () -> String?
-      end
-    end
-  end
-end

data/sig/hakumi_components/button/component.rbs

@@ -1,56 +0,0 @@
-# frozen_string_literal: true
-
-module HakumiComponents
-  module Button
-    class Component < HakumiComponents::BaseComponent
-      type button_type = :primary | :default | :dashed | :text | :link
-      type button_size = :small | :middle | :large
-      type button_shape = :default | :circle | :round
-      type html_button_type = :button | :submit | :reset
-
-      TYPES: Array[button_type]
-      SIZES: Array[button_size]
-      SHAPES: Array[button_shape]
-      HTML_TYPES: Array[html_button_type]
-
-      @type: button_type
-      @size: button_size
-      @html_type: html_button_type
-      @href: String?
-      @disabled: bool
-      @loading: bool
-      @danger: bool
-      @block: bool
-      @icon: (String | Symbol | untyped)?
-      @shape: button_shape
-      @html_options: hakumi_html_options
-
-      def initialize: (
-        ?type: button_type,
-        ?size: button_size,
-        ?html_type: html_button_type,
-        ?href: String?,
-        ?disabled: bool,
-        ?loading: bool,
-        ?danger: bool,
-        ?block: bool,
-        ?icon: (String | Symbol | untyped)?,
-        ?shape: button_shape,
-        **hakumi_html_options html_options
-      ) -> void
-
-      def call: () -> String
-
-      private
-
-      def validate_props!: () -> void
-      def tag_name: () -> Symbol
-      def wrapper_classes: () -> String
-      def wrapper_attributes: () -> hakumi_html_options
-      def content_wrapper: () -> String
-      def icon_element: () -> String?
-      def loading_icon: () -> String
-      def text_element: () -> String?
-    end
-  end
-end

data/sig/hakumi_components/calendar/component.rbs

@@ -1,41 +0,0 @@
-# frozen_string_literal: true
-
-module HakumiComponents
-  module Calendar
-    class Component < HakumiComponents::BaseComponent
-      type calendar_mode = "month" | "year"
-      type calendar_value = Date | Time | String
-
-      MODES: Array[String]
-
-      @value: calendar_value?
-      @default_value: calendar_value?
-      @mode: calendar_mode
-      @full_screen: bool
-      @disable_date: Proc?
-      @header_render: Proc?
-      @html_options: hakumi_html_options
-
-      def initialize: (
-        ?value: calendar_value?,
-        ?default_value: calendar_value?,
-        ?mode: calendar_mode,
-        ?full_screen: bool,
-        ?disable_date: Proc?,
-        ?header_render: Proc?,
-        **hakumi_html_options html_options
-      ) -> void
-
-      def call: () -> String
-
-      private
-
-      def validate_props!: () -> void
-      def wrapper_classes: () -> String
-      def wrapper_attributes: () -> hakumi_html_options
-      def render_header: () -> String
-      def render_body: () -> String
-      def current_date: () -> (Date | Time | String)
-    end
-  end
-end

data/sig/hakumi_components/card/component.rbs

@@ -1,50 +0,0 @@
-# frozen_string_literal: true
-
-module HakumiComponents
-  module Card
-    class Component < HakumiComponents::BaseComponent
-      type card_size = :default | :small
-      type card_type = :inner | nil
-
-      @title: (String | untyped)?
-      @extra: (String | untyped)?
-      @bordered: bool
-      @hoverable: bool
-      @loading: bool
-      @size: card_size
-      @type: card_type
-      @actions: Array[untyped]
-      @cover: (String | untyped)?
-      @href: String?
-      @target: String?
-      @html_options: hakumi_html_options
-
-      def initialize: (
-        ?title: (String | untyped)?,
-        ?extra: (String | untyped)?,
-        ?bordered: bool,
-        ?hoverable: bool,
-        ?loading: bool,
-        ?size: card_size,
-        ?type: card_type,
-        ?actions: Array[untyped],
-        ?cover: (String | untyped)?,
-        ?href: String?,
-        ?target: String?,
-        **hakumi_html_options html_options
-      ) -> void
-
-      private
-
-      def classes: () -> String
-
-      def head_classes: () -> String
-
-      def body_classes: () -> String
-
-      def render_title: () -> (String | untyped)?
-
-      def render_extra: () -> (String | untyped)?
-    end
-  end
-end

data/sig/hakumi_components/card/grid/component.rbs

@@ -1,21 +0,0 @@
-# frozen_string_literal: true
-
-module HakumiComponents
-  module Card
-    module Grid
-      class Component < HakumiComponents::BaseComponent
-        @hoverable: bool
-        @html_options: hakumi_html_options
-
-        def initialize: (
-          ?hoverable: bool,
-          **hakumi_html_options html_options
-        ) -> void
-
-        private
-
-        def classes: () -> String
-      end
-    end
-  end
-end

data/sig/hakumi_components/card/meta/component.rbs

@@ -1,25 +0,0 @@
-# frozen_string_literal: true
-
-module HakumiComponents
-  module Card
-    module Meta
-      class Component < HakumiComponents::BaseComponent
-        @title: (String | untyped)?
-        @description: (String | untyped)?
-        @avatar: (String | untyped)?
-        @html_options: hakumi_html_options
-
-        def initialize: (
-          ?title: (String | untyped)?,
-          ?description: (String | untyped)?,
-          ?avatar: (String | untyped)?,
-          **hakumi_html_options html_options
-        ) -> void
-
-        private
-
-        def classes: () -> String
-      end
-    end
-  end
-end

data/sig/hakumi_components/carousel/component.rbs

@@ -1,88 +0,0 @@
-# frozen_string_literal: true
-
-module HakumiComponents
-  module Carousel
-    class Component < HakumiComponents::BaseComponent
-      type carousel_effect = :scrollx | :fade
-      type carousel_dot_placement = :top | :bottom | :start | :end
-
-      EFFECTS: Array[carousel_effect]
-      DOT_PLACEMENTS: Array[carousel_dot_placement]
-
-      @autoplay: bool
-      @autoplay_speed: Integer
-      @dot_placement: carousel_dot_placement
-      @dots: bool
-      @dots_class: String?
-      @arrows: bool
-      @adaptive_height: bool
-      @draggable: bool
-      @infinite: bool
-      @fade: bool
-      @effect: carousel_effect
-      @speed: Integer
-      @easing: String
-      @wait_for_animate: bool
-      @autoplay_dot_duration: bool
-      @html_options: hakumi_html_options
-
-      def initialize: (
-        ?autoplay: (bool | Hash[Symbol, untyped]),
-        ?autoplay_speed: Integer,
-        ?dot_placement: carousel_dot_placement,
-        ?dots: (bool | Hash[Symbol, untyped]),
-        ?dots_class: String?,
-        ?arrows: bool,
-        ?adaptive_height: bool,
-        ?draggable: bool,
-        ?infinite: bool,
-        ?fade: bool?,
-        ?effect: carousel_effect,
-        ?speed: Integer,
-        ?easing: String,
-        ?wait_for_animate: bool,
-        **hakumi_html_options html_options
-      ) -> void
-
-      attr_reader autoplay: bool
-      attr_reader autoplay_speed: Integer
-      attr_reader dot_placement: carousel_dot_placement
-      attr_reader dots: bool
-      attr_reader dots_class: String?
-      attr_reader arrows: bool
-      attr_reader adaptive_height: bool
-      attr_reader draggable: bool
-      attr_reader infinite: bool
-      attr_reader fade: bool
-      attr_reader effect: carousel_effect
-      attr_reader speed: Integer
-      attr_reader easing: String
-      attr_reader wait_for_animate: bool
-      attr_reader autoplay_dot_duration: bool
-
-      def carousel_classes: () -> String
-
-      def dots?: () -> bool
-
-      def arrows?: () -> bool
-
-      def dots_classes: () -> String
-
-      def slide_classes: (Integer index) -> String
-
-      def dot_classes: (Integer index) -> String
-
-      def stimulus_controller: () -> String
-
-      def stimulus_values: () -> Hash[Symbol, untyped]
-
-      def stimulus_data_attributes: () -> Hash[String, untyped]
-
-      def wrapper_attributes: () -> hakumi_html_options
-
-      private
-
-      def validate_props!: () -> void
-    end
-  end
-end

data/sig/hakumi_components/cascader/component.rbs

@@ -1,52 +0,0 @@
-# frozen_string_literal: true
-
-module HakumiComponents
-  module Cascader
-    class Component < HakumiComponents::BaseComponent
-      type cascader_option = {
-        value: String,
-        label: String,
-        children: Array[cascader_option]?
-      }
-
-      SIZES: Array[hakumi_size_standard]
-      TRIGGERS: Array[hakumi_trigger]
-
-      @name: String
-      @options: Array[Hash[Symbol, untyped]]
-      @value: Array[String | Integer | Float]
-      @placeholder: String
-      @size: hakumi_size_standard
-      @disabled: bool
-      @allow_clear: bool
-      @show_search: bool
-      @change_on_select: bool
-      @expand_trigger: hakumi_trigger
-      @display_render: Proc?
-      @html_options: hakumi_html_options
-
-      def initialize: (
-        ?name: String?,
-        ?options: Array[Hash[Symbol, untyped]],
-        ?value: Array[String | Integer | Float],
-        ?placeholder: String,
-        ?size: hakumi_size_standard,
-        ?disabled: bool,
-        ?allow_clear: bool,
-        ?show_search: bool,
-        ?change_on_select: bool,
-        ?expand_trigger: hakumi_trigger,
-        ?display_render: Proc?,
-        **hakumi_html_options html_options
-      ) -> void
-
-      def validate_props!: () -> void
-
-      def wrapper_classes: () -> String
-
-      def wrapper_attributes: () -> hakumi_html_options
-
-      def selected_label: () -> String?
-    end
-  end
-end