hakumi_components 0.1.3.pre

data/sig/hakumi/color_picker/component.rbs

@@ -0,0 +1,81 @@
+# frozen_string_literal: true
+
+module Hakumi
+  module ColorPicker
+    class Component < Hakumi::BaseComponent
+      include Hakumi::Concerns::FormField
+
+      type color_format = :hex | :rgb | :hsl | :hsb
+      type trigger_type = :click | :hover
+      type placement_type = :bottom_left | :bottom_right | :top_left | :top_right | :bottom | :top
+      type preset_group = { label: String?, colors: Array[String] }
+      type preset_hash = Hash[String, Array[String]]
+      type preset_input = preset_hash | Array[preset_group] | Array[String]
+
+      SIZES: Array[hakumi_size_standard]
+      TRIGGERS: Array[trigger_type]
+      FORMATS: Array[color_format]
+      DEFAULT_PRESET_COLORS: Array[String]
+
+      @name: String
+      @label: String?
+      @caption: String?
+      @value: String?
+      @default_value: String
+      @format: color_format
+      @show_text: bool
+      @show_format_select: bool
+      @disabled: bool
+      @disabled_alpha: bool
+      @allow_clear: bool
+      @show_preset_colors: bool
+      @default_preset_label: String
+      @presets: Array[preset_group]
+      @size: hakumi_size_standard
+      @trigger: trigger_type
+      @placement: placement_type
+      @standalone: bool
+      @errors: Array[String]
+      @html_attrs: hakumi_html_options
+
+      def initialize: (
+        ?name: String?,
+        ?label: String?,
+        ?caption: String?,
+        ?value: String?,
+        ?default_value: String?,
+        ?format: color_format,
+        ?show_text: bool,
+        ?show_format_select: bool,
+        ?disabled: bool,
+        ?disabled_alpha: bool,
+        ?allow_clear: bool,
+        ?show_preset_colors: bool,
+        ?default_preset_label: String,
+        ?presets: preset_input,
+        ?size: hakumi_size_standard,
+        ?trigger: trigger_type,
+        ?placement: placement_type,
+        ?standalone: bool,
+        ?errors: (Array[String] | String),
+        **hakumi_html_options html_attrs
+      ) -> void
+
+      def wrapper_attributes: () -> hakumi_html_options
+      def trigger_size_class: () -> String
+      def display_value: () -> String
+      def presets?: () -> bool
+      def preset_groups: () -> Array[preset_group]
+      def default_presets: () -> Array[preset_group]
+      def all_preset_groups: () -> Array[preset_group]
+
+      private
+
+      def validate_props!: () -> void
+      def component_classes: () -> String
+      def data_value: (String? value) -> String?
+      def normalize_presets: (preset_input? presets) -> Array[preset_group]
+      def cast_boolean: (untyped value) -> bool
+    end
+  end
+end

data/sig/hakumi/concerns/form_field.rbs

@@ -0,0 +1,89 @@
+# frozen_string_literal: true
+
+module Hakumi
+  module Concerns
+    # Shared behavior for form field components
+    # Provides common methods for handling errors, labels, captions, and accessibility
+    module FormField
+      # Attribute readers provided by concern
+      def name: () -> String
+
+      def label: () -> String?
+
+      def caption: () -> String?
+
+      def errors: () -> Array[String]
+
+      def required: () -> bool
+
+      def size: () -> Symbol
+
+      def standalone: () -> bool
+
+      # Check if field has validation errors
+      #
+      # @return [Boolean]
+      def has_error?: () -> bool
+
+      # Check if component is in standalone mode
+      #
+      # @return [Boolean]
+      def standalone?: () -> bool
+
+      # Get the input field ID
+      # Works with both @html_options and @html_attrs
+      #
+      # @return [String]
+      def input_id: () -> String
+
+      # Generate CSS classes for form item wrapper
+      #
+      # @return [String]
+      def form_item_classes: () -> String
+
+      # Generate aria-describedby attribute value
+      #
+      # @return [String, nil]
+      def describedby_ids: () -> String?
+
+      # Get first error message
+      #
+      # @return [String, nil]
+      def error_message: () -> String?
+
+      # Render label element (wraps label in div for proper styling)
+      #
+      # @param field_id [String] ID of the input field
+      # @return [String, nil]
+      def render_label: (?field_id: String?) -> String?
+
+      # Render caption (help text) element
+      #
+      # @return [String, nil]
+      def render_caption: () -> String?
+
+      # Render error message element
+      #
+      # @return [String, nil]
+      def render_error: () -> String?
+
+      # Render explain section (caption or error)
+      #
+      # @return [String, nil]
+      def render_explain: () -> String?
+
+      # Generate form item wrapper attributes
+      #
+      # @param additional_data [Hash] Additional data attributes for Stimulus controllers
+      # @return [Hash] HTML attributes hash with class, data, etc.
+      def form_item_attributes: (?additional_data: Hash[Symbol, (String | Integer | bool)]) -> hakumi_html_options
+
+      # Methods expected from BaseComponent (duck typing interface)
+      # These are called by FormField but defined in BaseComponent
+      def class_names: (String base, ?Hash[Symbol, (Symbol | String | Integer | bool)] modifiers, ?Array[String] extras) -> String
+      def content_tag: (Symbol tag_name, String? content, **hakumi_html_attribute_value attributes) -> String
+                    | (Symbol tag_name, **hakumi_html_attribute_value attributes) { () -> String? } -> String
+      def safe_join: (Array[untyped] array, ?String separator) -> String
+    end
+  end
+end

data/sig/hakumi/container/component.rbs

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module Hakumi
+  module Container
+    class Component < Hakumi::BaseComponent
+      type container_width = :narrow | :default | :wide | :xl | :fluid | Numeric | String
+
+      WIDTH_PRESETS: Hash[Symbol, String]
+
+      @width: container_width
+      @padded: bool
+      @centered: bool
+      @full_height: bool
+      @html_options: hakumi_html_options
+
+      def initialize: (
+        ?width: container_width,
+        ?padded: bool,
+        ?centered: bool,
+        ?full_height: bool,
+        **hakumi_html_options html_options
+      ) -> void
+
+      def call: () -> String
+
+      private
+
+      def wrapper_attributes: () -> hakumi_html_options
+
+      def wrapper_classes: () -> String
+
+      def width_class: () -> String?
+
+      def width_style: () -> String?
+    end
+  end
+end

data/sig/hakumi/date_picker/component.rbs

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+module Hakumi
+  module DatePicker
+    class Component < Hakumi::BaseComponent
+      include Hakumi::Concerns::FormField
+
+      type picker_type = :date | :week | :month | :quarter | :year
+      type date_value = String | Time | DateTime | Date | nil
+
+      SIZES: Array[hakumi_size_standard]
+      PICKERS: Array[picker_type]
+
+      @name: String
+      @label: String?
+      @caption: String?
+      @value: date_value
+      @default_value: date_value
+      @format: String?
+      @display_format: String?
+      @picker: picker_type
+      @show_time: bool
+      @show_seconds: bool
+      @disabled: bool
+      @disabled_date: Proc?
+      @allow_clear: bool
+      @placeholder: String?
+      @size: hakumi_size_standard
+      @bordered: bool
+      @required: bool
+      @errors: Array[String]
+      @standalone: bool
+      @html_options: hakumi_html_options
+
+      def initialize: (
+        ?name: String?,
+        ?label: String?,
+        ?caption: String?,
+        ?value: date_value,
+        ?default_value: date_value,
+        ?format: String?,
+        ?display_format: String?,
+        ?picker: picker_type,
+        ?show_time: bool,
+        ?show_seconds: bool?,
+        ?disabled: bool,
+        ?disabled_date: Proc?,
+        ?allow_clear: bool,
+        ?placeholder: String?,
+        ?size: hakumi_size_standard,
+        ?bordered: bool,
+        ?required: bool,
+        ?errors: (Array[String] | String),
+        ?standalone: bool,
+        **hakumi_html_options html_options
+      ) -> void
+
+      def wrapper_attributes: () -> hakumi_html_options
+      def hidden_input_attributes: () -> hakumi_html_options
+      def visible_input_attributes: () -> hakumi_html_options
+      def input_attributes: () -> hakumi_html_options
+      def display_value: () -> String?
+
+      private
+
+      def validate_props!: () -> void
+      def formatted_hours: () -> Array[String]
+      def formatted_minutes: () -> Array[String]
+      def formatted_seconds: () -> Array[String]
+    end
+  end
+end

data/sig/hakumi/date_picker/range_picker.rbs

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+module Hakumi
+  module DatePicker
+    class RangePicker < Hakumi::BaseComponent
+      include Hakumi::Concerns::FormField
+      include SharedRendering
+
+      @name: String
+      @label: String?
+      @caption: String?
+      @start_value: SharedRendering::datetime_value
+      @end_value: SharedRendering::datetime_value
+      @value: SharedRendering::datetime_value
+      @default_value: SharedRendering::datetime_value
+      @format: String?
+      @picker: Symbol
+      @show_time: bool
+      @disabled: bool
+      # disabled_date is a Proc passed to Calendar component, or nil
+      @disabled_date: untyped
+      @allow_clear: bool
+      @placeholder: (String | Array[String])?
+      @size: Symbol
+      @bordered: bool
+      @required: bool
+      @errors: Array[String]
+      @standalone: bool
+      @html_options: hakumi_html_options
+
+      def initialize: (
+        ?name: String?,
+        ?label: String?,
+        ?caption: String?,
+        ?start_value: SharedRendering::datetime_value,
+        ?end_value: SharedRendering::datetime_value,
+        ?default_value: SharedRendering::datetime_value,
+        ?format: String?,
+        ?picker: Symbol,
+        ?show_time: bool,
+        ?disabled: bool,
+        # disabled_date is a Proc for Calendar component
+        ?disabled_date: untyped,
+        ?allow_clear: bool,
+        ?placeholder: (String | Array[String])?,
+        ?size: Symbol,
+        ?bordered: bool,
+        ?required: bool,
+        ?errors: Array[String],
+        ?standalone: bool,
+        **hakumi_html_options html_options
+      ) -> void
+
+      def wrapper_attributes: () -> hakumi_html_options
+      def start_input_attributes: () -> hakumi_html_options
+      def end_input_attributes: () -> hakumi_html_options
+      def start_input_name: () -> String
+      def end_input_name: () -> String
+      def start_input_id: () -> String
+      def end_input_id: () -> String
+      def display_values: () -> Array[String?]
+
+      private
+
+      def validate_props!: () -> void
+    end
+  end
+end

data/sig/hakumi/date_picker/shared_rendering.rbs

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module Hakumi
+  module DatePicker
+    module SharedRendering
+      SIZES: Array[Symbol]
+      PICKERS: Array[Symbol]
+
+      DEFAULT_DATE_FORMAT: String
+      DEFAULT_DATETIME_FORMAT: String
+      DEFAULT_DATETIME_NO_SECONDS_FORMAT: String
+
+      # Date/time value can be String, Time, DateTime, Date, or nil
+      type datetime_value = String | Time | DateTime | Date | nil
+
+      def iso_value: (datetime_value value) -> String?
+      def formatted_value: (datetime_value value) -> String?
+      def js_display_format: () -> String
+      def display_format: () -> String
+      def default_strftime_format: () -> String
+      def dayjs_to_strftime: (String dayjs_format) -> String
+      def parse_datetime: (datetime_value value) -> (Time | DateTime | Date | nil)
+      def parse_date: (datetime_value value) -> Date?
+      def show_seconds?: () -> bool
+      def use_12_hours?: () -> bool
+      def format_quarter: (Date | DateTime | Time date_value) -> String
+      def picker_mode: () -> Symbol
+      def base_wrapper_classes: (base: String, ?extra_classes: Array[String?]) -> String
+      # Returns data attributes for picker panel (range is data attribute value)
+      def picker_panel_attributes: (?range: String?) -> Hash[Symbol, String]
+      # Returns options hash for Calendar component (disabled_date is Proc or nil, value is datetime)
+      def calendar_component_options: (value: datetime_value, ?range: String?) -> Hash[Symbol, untyped]
+      def placeholder_text: () -> String
+      def range_placeholders: () -> Array[String]
+
+      # Required helpers provided by BaseComponent
+      def class_names: (String base, ?Hash[Symbol, bool] modifiers, ?Array[String?] extras) -> String
+      def value_present?: (untyped value) -> bool
+    end
+  end
+end

data/sig/hakumi/descriptions/component.rbs

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+module Hakumi
+  module Descriptions
+    class Component < Hakumi::BaseComponent
+      type descriptions_size = :default | :middle | :small
+      type descriptions_layout = :horizontal | :vertical
+      type descriptions_breakpoint = :xs | :sm | :md | :lg | :xl | :xxl
+
+      SIZE_OPTIONS: Array[descriptions_size]
+      LAYOUT_OPTIONS: Array[descriptions_layout]
+      COLUMN_BREAKPOINTS: Array[descriptions_breakpoint]
+
+      @title: (String | untyped)?
+      @extra: (String | untyped)?
+      @bordered: bool
+      @size: descriptions_size
+      @layout: descriptions_layout
+      @column: (Integer | Hash[Symbol, Integer])
+      @colon: bool
+      @html_options: hakumi_html_options
+
+      def initialize: (
+        ?title: (String | untyped)?,
+        ?extra: (String | untyped)?,
+        ?bordered: bool,
+        ?size: descriptions_size,
+        ?layout: descriptions_layout,
+        ?column: (Integer | Hash[Symbol, Integer]),
+        ?colon: bool,
+        **hakumi_html_options html_options
+      ) -> void
+
+      private
+
+      def validate_props!: () -> void
+
+      def max_column_count: () -> (Integer | Hash[Symbol, Integer])
+
+      def rows: () -> Array[Array[[Hakumi::Descriptions::Item::Component, Integer]]]
+
+      def wrapper_classes: () -> String
+
+      def build_column_classes: () -> Array[String]
+
+      def wrapper_attributes: () -> hakumi_html_options
+
+      def table_classes: () -> String
+
+      def label_cell_classes: () -> String
+
+      def content_cell_classes: () -> String
+
+      def render_title: () -> String?
+
+      def render_extra: () -> String?
+    end
+  end
+end

data/sig/hakumi/descriptions/item/component.rbs

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Hakumi
+  module Descriptions
+    module Item
+      class Component < Hakumi::BaseComponent
+        @label: (String | untyped)
+        @content: (String | untyped)?
+        @span: Integer
+        @label_style: (String | Hash[Symbol, untyped])?
+        @content_style: (String | Hash[Symbol, untyped])?
+        @html_options: hakumi_html_options
+
+        def initialize: (
+          label: (String | untyped),
+          ?content: (String | untyped)?,
+          ?span: Integer,
+          ?label_style: (String | Hash[Symbol, untyped])?,
+          ?content_style: (String | Hash[Symbol, untyped])?,
+          **hakumi_html_options html_options
+        ) -> void
+
+        attr_accessor content: (String | untyped)?
+        attr_reader label: (String | untyped)
+        attr_reader span: Integer
+        attr_reader label_style: (String | Hash[Symbol, untyped])?
+        attr_reader content_style: (String | Hash[Symbol, untyped])?
+      end
+    end
+  end
+end

data/sig/hakumi/divider/component.rbs

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module Hakumi
+  module Divider
+    class Component < Hakumi::BaseComponent
+      type divider_orientation = :horizontal | :vertical
+      type divider_placement = :left | :center | :right
+
+      ORIENTATIONS: Array[divider_orientation]
+      PLACEMENTS: Array[divider_placement]
+
+      @orientation: divider_orientation
+      @dashed: bool
+      @plain: bool
+      @orientation_margin: divider_placement?
+      @html_options: hakumi_html_options
+
+      def initialize: (
+        ?orientation: divider_orientation,
+        ?dashed: bool,
+        ?plain: bool,
+        ?orientation_margin: divider_placement?,
+        **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 content_wrapper: () -> String?
+    end
+  end
+end

data/sig/hakumi/drawer/component.rbs

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+module Hakumi
+  module Drawer
+    class Component < Hakumi::BaseComponent
+      type drawer_placement = :left | :right | :top | :bottom
+      type drawer_size = :default | :large | Numeric | String
+
+      PLACEMENTS: Array[drawer_placement]
+      SIZES: Hash[Symbol, Integer]
+
+      # Extracts locals from controller params for dynamic rendering
+      def self.extract_controller_locals: (untyped params) -> Hash[Symbol, untyped]
+
+      @open: bool
+      @title: String?
+      @placement: drawer_placement
+      @size: drawer_size
+      @width: (Numeric | String)?
+      @height: (Numeric | String)?
+      @closable: bool
+      @mask: bool
+      @mask_closable: bool
+      @keyboard: bool
+      @footer: untyped
+      @extra: untyped
+      @destroy_on_close: bool
+      @html_attributes: hakumi_html_options
+
+      def initialize: (
+        ?open: bool,
+        ?title: String?,
+        ?placement: drawer_placement,
+        ?size: drawer_size,
+        ?width: (Numeric | String)?,
+        ?height: (Numeric | String)?,
+        ?closable: bool,
+        ?mask: bool,
+        ?mask_closable: bool,
+        ?keyboard: bool,
+        ?footer: untyped,
+        ?extra: untyped,
+        ?destroy_on_close: bool,
+        **hakumi_html_options html_attributes
+      ) -> void
+
+      def drawer_classes: () -> String
+
+      def root_attributes: () -> hakumi_html_options
+
+      def data_attributes: () -> hakumi_html_options
+
+      def wrapper_style: () -> String
+
+      def render_header?: () -> bool
+
+      def render_footer?: () -> bool
+
+      private
+
+      def resolve_size: () -> drawer_size
+
+      def validate_props!: () -> void
+    end
+  end
+end

data/sig/hakumi/dropdown/component.rbs

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module Hakumi
+  module Dropdown
+    class Component < Hakumi::BaseComponent
+      type dropdown_trigger = :hover | :click | :context_menu
+      type dropdown_placement = :bottom | :bottom_left | :bottom_right | :top | :top_left | :top_right
+
+      TRIGGERS: Array[dropdown_trigger]
+      PLACEMENTS: Array[dropdown_placement]
+
+      @trigger: dropdown_trigger
+      @placement: dropdown_placement
+      @disabled: bool
+      @html_options: hakumi_html_options
+
+      def initialize: (
+        ?trigger: dropdown_trigger,
+        ?placement: dropdown_placement,
+        ?disabled: bool,
+        **hakumi_html_options html_options
+      ) -> void
+
+      attr_reader trigger_type: dropdown_trigger
+      attr_reader placement: dropdown_placement
+      attr_reader disabled: bool
+
+      def dropdown_classes: () -> String
+
+      def menu_classes: () -> String
+
+      def stimulus_controller: () -> String
+
+      def stimulus_values: () -> Hash[Symbol, untyped]
+
+      def placement_class: () -> String
+
+      def wrapper_attributes: () -> hakumi_html_options
+
+      private
+
+      def validate_props!: () -> void
+    end
+  end
+end

data/sig/hakumi/dropdown/divider/component.rbs

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Hakumi
+  module Dropdown
+    module Divider
+      class Component < Hakumi::BaseComponent
+        def call: () -> String
+      end
+    end
+  end
+end

data/sig/hakumi/dropdown/item/component.rbs

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module Hakumi
+  module Dropdown
+    module Item
+      class Component < Hakumi::BaseComponent
+        @key: String
+        @label: String?
+        @href: String?
+        @target: String?
+        @icon: hakumi_icon?
+        @disabled: bool
+        @danger: bool
+        @html_options: hakumi_html_options
+
+        def initialize: (
+          key: String,
+          ?label: String?,
+          ?href: String?,
+          ?target: String?,
+          ?icon: hakumi_icon?,
+          ?disabled: bool,
+          ?danger: bool,
+          **hakumi_html_options html_options
+        ) -> void
+
+        attr_reader key: String
+        attr_reader label: String?
+        attr_reader href: String?
+        attr_reader target: String?
+        attr_reader icon: hakumi_icon?
+        attr_reader disabled: bool
+        attr_reader danger: bool
+
+        def item_classes: () -> String
+
+        def link?: () -> bool
+
+        def display_label: () -> (String | untyped)?
+
+        def icon_component: () -> (Hakumi::Icon::Component | hakumi_icon)?
+      end
+    end
+  end
+end