hakumi_components 0.1.17.pre → 0.1.19.pre

data/sig/hakumi/concerns/form_field.rbs

@@ -1,89 +0,0 @@
-# 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

@@ -1,37 +0,0 @@
-# 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

@@ -1,72 +0,0 @@
-# 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

@@ -1,68 +0,0 @@
-# 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

@@ -1,41 +0,0 @@
-# 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

@@ -1,59 +0,0 @@
-# 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

@@ -1,31 +0,0 @@
-# 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

@@ -1,39 +0,0 @@
-# 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

@@ -1,66 +0,0 @@
-# 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

@@ -1,45 +0,0 @@
-# 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

@@ -1,11 +0,0 @@
-# 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

@@ -1,45 +0,0 @@
-# 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

data/sig/hakumi/empty/component.rbs

@@ -1,40 +0,0 @@
-# frozen_string_literal: true
-
-module Hakumi
-  module Empty
-    class Component < Hakumi::BaseComponent
-      type empty_image = :default | :simple
-
-      BUILT_IN_IMAGES: Array[empty_image]
-      DEFAULT_IMAGE_SVG: String
-      SIMPLE_IMAGE_SVG: String
-      DEFAULT_DESCRIPTION: String
-
-      @image: empty_image | String | untyped
-      @image_height: Integer?
-      @description: String | false
-      @html_options: hakumi_html_options
-
-      def initialize: (
-        ?image: empty_image | String | untyped,
-        ?image_height: Integer?,
-        ?description: String | false,
-        **hakumi_html_options html_options
-      ) -> void
-
-      def call: () -> String
-
-      private
-
-      def image_element: () -> String
-
-      def render_image: () -> String
-
-      def image_alt: () -> (String | false)
-
-      def description_element: () -> String?
-
-      def footer_element: () -> String?
-    end
-  end
-end

data/sig/hakumi/flex/component.rbs

@@ -1,47 +0,0 @@
-# frozen_string_literal: true
-
-module Hakumi
-  module Flex
-    class Component < Hakumi::BaseComponent
-      type flex_wrap = :wrap | :nowrap | :"wrap-reverse"
-      type flex_justify = :start | :end | :center | :"space-between" | :"space-around" | :"space-evenly"
-      type flex_align = :start | :end | :center | :baseline | :stretch
-      type flex_gap = :small | :middle | :large | Numeric | String
-
-      WRAP_OPTIONS: Array[flex_wrap]
-      JUSTIFY_OPTIONS: Array[flex_justify]
-      ALIGN_OPTIONS: Array[flex_align]
-      GAP_OPTIONS: Array[Symbol]
-
-      @vertical: bool
-      @wrap: flex_wrap
-      @justify: flex_justify
-      @align: flex_align
-      @gap: flex_gap?
-      @component: Symbol
-      @html_options: hakumi_html_options
-
-      def initialize: (
-        ?vertical: bool,
-        ?wrap: flex_wrap,
-        ?justify: flex_justify,
-        ?align: flex_align,
-        ?gap: flex_gap?,
-        ?component: Symbol,
-        **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 normalize_prop: (Symbol prop) -> Symbol
-    end
-  end
-end