hakumi_components 0.1.3.pre

data/sig/hakumi/timeline/component.rbs

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+module Hakumi
+  module Timeline
+    class Component < Hakumi::BaseComponent
+      type timeline_direction = :vertical | :horizontal
+      type timeline_mode = :left | :right | :alternate
+      type timeline_variant = :filled | :outlined
+
+      DIRECTIONS: Array[timeline_direction]
+      MODES: Array[timeline_mode]
+      VARIANTS: Array[timeline_variant]
+
+      @direction: timeline_direction
+      @mode: timeline_mode
+      @reverse: bool
+      @pending: (String | bool)?
+      @pending_dot: untyped  # String, Symbol, or ViewComponent
+      @title_span: (String | Integer)?
+      @variant: timeline_variant
+      @html_options: hakumi_html_options
+
+      # Class methods for controller integration
+      def self.extract_controller_locals: (Hash[Symbol, untyped] params) -> Hash[Symbol, untyped]
+      def self.parse_json_param: (untyped value) -> untyped
+
+      def initialize: (
+        ?direction: timeline_direction,
+        ?mode: timeline_mode,
+        ?reverse: bool,
+        ?pending: (String | bool)?,
+        ?pending_dot: untyped,
+        ?title_span: (String | Integer)?,
+        ?variant: timeline_variant,
+        **hakumi_html_options html_options
+      ) -> void
+
+      attr_reader direction: timeline_direction
+      attr_reader mode: timeline_mode
+      attr_reader reverse: bool
+      attr_reader pending: (String | bool)?
+      attr_reader pending_dot: untyped
+      attr_reader title_span: (String | Integer)?
+      attr_reader variant: timeline_variant
+
+      def wrapper_attributes: () -> hakumi_html_options
+      def timeline_items: () -> Array[untyped]  # Array of Item::Component
+      def item_position: (Integer index, untyped item) -> (:left | :right)
+      def pending_item: () -> untyped  # Item::Component or nil
+
+      private
+
+      def stimulus_controller: () -> String
+      def stimulus_data: () -> Hash[Symbol | String, untyped]
+      def timeline_classes: () -> String
+      def timeline_style: () -> (String | nil)
+      def validate_props!: () -> void
+      def normalized_title_span: () -> (String | nil)
+    end
+  end
+end

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

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+module Hakumi
+  module Timeline
+    module Item
+      class Component < Hakumi::BaseComponent
+        type timeline_color_preset = :blue | :red | :green | :gray
+        type timeline_position = :left | :right
+
+        COLORS: Hash[timeline_color_preset, String]
+        POSITIONS: Array[timeline_position]
+
+        @title: (String | untyped)?  # String or ViewComponent
+        @body: (String | untyped)?  # String or ViewComponent
+        @color: (timeline_color_preset | String)
+        @dot: untyped  # String, Symbol, or ViewComponent
+        @position: (timeline_position | nil)
+        @loading: bool
+        @parent: untyped  # Parent Timeline::Component
+        @pending: bool
+        @html_options: hakumi_html_options
+        @content_block: (Proc | nil)
+        @index: (Integer | nil)
+        @total: (Integer | nil)
+        @resolved_position: (timeline_position | nil)
+        @reverse: (bool | nil)
+        @dot_content: (String | nil)
+
+        def initialize: (
+          ?title: (String | untyped)?,
+          ?body: (String | untyped)?,
+          ?color: (timeline_color_preset | String),
+          ?dot: untyped,
+          ?position: (timeline_position | nil),
+          ?loading: bool,
+          ?parent: untyped,
+          ?pending: bool,
+          **hakumi_html_options html_options
+        ) { () -> untyped } -> void
+
+        attr_reader title: (String | untyped)?
+        attr_reader body: (String | untyped)?
+        attr_reader color: (timeline_color_preset | String)
+        attr_reader dot: untyped
+        attr_reader position: (timeline_position | nil)
+        attr_reader loading: bool
+        attr_reader parent: untyped
+        attr_reader pending: bool
+
+        # Sets context information (index, position) from parent Timeline
+        def with_context: (index: Integer, total: Integer, ?position: timeline_position?, ?reverse: bool) -> self
+
+        def wrapper_attributes: () -> hakumi_html_options
+        def item_content: () -> (String | nil)
+        def resolved_position: () -> (timeline_position | nil)
+        def last_item?: () -> bool
+        def dot_component?: () -> bool
+        def dot_content: () -> (String | nil)
+
+        private
+
+        def item_classes: () -> String
+        def item_data: () -> Hash[Symbol, Integer]
+        def dot_style: () -> (String | nil)
+        def color_value_for: ((timeline_color_preset | String) value) -> (String | nil)
+        def validate_props!: () -> void
+      end
+    end
+  end
+end

data/sig/hakumi/tooltip/component.rbs

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+module Hakumi
+  module Tooltip
+    class Component < Hakumi::BaseComponent
+      type tooltip_trigger = :hover | :focus | :click
+      type tooltip_placement = :top | :top_left | :top_right | :bottom | :bottom_left | :bottom_right | :left | :left_top | :left_bottom | :right | :right_top | :right_bottom
+      type tooltip_color = :default | :pink | :red | :yellow | :orange | :cyan | :green | :blue | :purple | :geekblue | :magenta | :volcano | :gold | :lime
+
+      TRIGGERS: Array[tooltip_trigger]
+      PLACEMENTS: Array[tooltip_placement]
+      COLORS: Array[tooltip_color]
+
+      @title: String?
+      @placement: tooltip_placement
+      @trigger: tooltip_trigger
+      @arrow: bool
+      @color: (tooltip_color | String)
+      @open: bool?
+      @fresh: bool
+      @html_options: hakumi_html_options
+
+      attr_reader title: String?
+      attr_reader placement: tooltip_placement
+      attr_reader trigger: tooltip_trigger
+      attr_reader arrow: bool
+      attr_reader color: (tooltip_color | String)
+      attr_reader open: bool?
+      attr_reader fresh: bool
+
+      def initialize: (
+        ?title: String?,
+        ?placement: tooltip_placement,
+        ?trigger: tooltip_trigger,
+        ?arrow: bool,
+        ?color: (tooltip_color | String),
+        ?open: bool?,
+        ?fresh: bool,
+        **hakumi_html_options html_options
+      ) -> void
+
+      def wrapper_classes: () -> String
+
+      def tooltip_classes: () -> String
+
+      def placement_class: () -> String
+
+      def color_class: () -> String?
+
+      def preset_color?: () -> bool
+
+      def custom_color?: () -> bool
+
+      def custom_color_style: () -> String?
+
+      def stimulus_controller: () -> String
+
+      def stimulus_values: () -> Hash[Symbol, untyped]
+
+      def wrapper_attributes: () -> hakumi_html_options
+
+      def stimulus_data_attributes: () -> hakumi_html_options
+
+      def tooltip_text: () -> String?
+
+      def has_tooltip_content?: () -> bool
+
+      private
+
+      def validate_props!: () -> void
+    end
+  end
+end

data/sig/hakumi/tour/component.rbs

@@ -0,0 +1,84 @@
+# frozen_string_literal: true
+
+module Hakumi
+  module Tour
+    class Component < Hakumi::BaseComponent
+      type tour_size = "small" | "default" | "large"
+      type tour_type = "default" | "primary"
+      type tour_placement = "top" | "top_left" | "top_right" | "bottom" | "bottom_left" | "bottom_right" | "left" | "left_top" | "left_bottom" | "right" | "right_top" | "right_bottom"
+
+      type tour_step = {
+        title: String,
+        body: String,
+        target: String?,
+        placement: String
+      }
+
+      SIZES: Array[tour_size]
+      TYPES: Array[tour_type]
+      PLACEMENTS: Array[tour_placement]
+
+      @steps: Array[untyped]
+      @open: bool
+      @current: Integer
+      @size: tour_size
+      @type: tour_type
+      @placement: tour_placement
+      @mask: bool
+      @mask_closable: bool
+      @closable: bool
+      @show_progress: bool
+      @html_attrs: hakumi_html_options
+      @component_id: String
+      @normalized_steps: Array[tour_step]?
+
+      def initialize: (
+        ?steps: Array[untyped],
+        ?open: bool,
+        ?current: Integer,
+        ?size: tour_size,
+        ?type: tour_type,
+        ?placement: tour_placement,
+        ?mask: bool,
+        ?mask_closable: bool,
+        ?closable: bool,
+        ?show_progress: bool,
+        **hakumi_html_options html_attrs
+      ) -> void
+
+      def component_html_attributes: () -> hakumi_html_options
+
+      def title_id: () -> String
+
+      def body_id: () -> String
+
+      def current_step_title: () -> String
+
+      def current_step_body: () -> String
+
+      def progress_label: () -> String?
+
+      def first_step?: () -> bool
+
+      def last_step?: () -> bool
+
+      private
+
+      def component_html_class: () -> String
+
+      def validate_props!: () -> void
+
+      def validate_steps!: () -> void
+
+      def normalized_steps: () -> Array[tour_step]
+
+      def steps_json: () -> String
+
+      def current_step: () -> tour_step
+
+      def current_index: () -> Integer
+
+      def normalized_placement: ((String | Symbol)? value) -> String
+    end
+  end
+end

data/sig/hakumi/transfer/component.rbs

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+module Hakumi
+  module Transfer
+    class Component < Hakumi::BaseComponent
+      type pagination_config = bool | Hash[Symbol, untyped]
+
+      DEFAULT_TITLES: Array[String]
+
+      @data_source: Array[Hash[Symbol, untyped]]
+      @target_keys: Array[String]
+      @titles: Array[String]
+      @disabled: bool
+      @show_search: bool
+      @show_select_all: bool
+      @one_way: bool
+      @pagination: pagination_config
+      @name: String
+      @render_item: (Proc | untyped)?
+      @operations: Hash[Symbol, Symbol]
+      @search_placeholder: String?
+      @html_options: hakumi_html_options
+
+      def self.extract_controller_locals: (Hash[Symbol, untyped] params) -> Hash[Symbol, untyped]
+      def self.parse_data_source: (untyped value) -> Array[untyped]
+      def self.parse_json_array: (untyped value) -> Array[untyped]
+      def self.parse_pagination: (untyped value) -> pagination_config
+      def self.boolean_param: (untyped value, ?default: bool) -> bool
+
+      def initialize: (
+        data_source: Array[untyped],
+        ?target_keys: Array[untyped],
+        ?titles: (Array[String] | String)?,
+        ?disabled: bool,
+        ?show_search: bool,
+        ?show_select_all: bool,
+        ?one_way: bool,
+        ?pagination: pagination_config,
+        ?name: String?,
+        ?render_item: (Proc | untyped)?,
+        ?operations: Hash[Symbol, Symbol]?,
+        ?search_placeholder: String?,
+        **hakumi_html_options html_options
+      ) -> void
+
+      attr_reader titles: Array[String]
+      attr_reader operations: Hash[Symbol, Symbol]
+
+      def search_placeholder: () -> String
+      def wrapper_attributes: () -> hakumi_html_options
+      def source_items: () -> Array[Hash[Symbol, untyped]]
+      def target_items: () -> Array[Hash[Symbol, untyped]]
+      def show_search?: () -> bool
+      def show_select_all?: () -> bool
+      def disabled?: () -> bool
+      def one_way?: () -> bool
+      def pagination?: () -> bool
+      def item_classes: (Hash[Symbol, untyped] item) -> String
+      def item_checkbox_id: (Hash[Symbol, untyped] item, String panel, Integer index) -> String
+      def item_content: (Hash[Symbol, untyped] item) -> String?
+      def item_description: (Hash[Symbol, untyped] item) -> String?
+
+      private
+
+      def wrapper_classes: () -> String
+      def data_attributes: () -> hakumi_html_options
+      def pagination_data_value: () -> (String | Hash[Symbol, untyped] | bool | nil)
+      def normalize_data_source: (Array[untyped] data_source) -> Array[Hash[Symbol, untyped]]
+      def normalize_titles: ((Array[String] | String)? titles) -> Array[Array[String] | String]
+      def normalize_operations: (Hash[Symbol, Symbol]? operations) -> Hash[Symbol, Symbol]
+      def cast_boolean: (untyped value) -> bool
+      def normalize_string: (untyped value) -> String?
+      def validate_props!: () -> void
+    end
+  end
+end

data/sig/hakumi/tree/component.rbs

@@ -0,0 +1,126 @@
+# frozen_string_literal: true
+
+module Hakumi
+  module Tree
+    class Component < Hakumi::BaseComponent
+      DEFAULT_INDENT: Integer
+
+      # Tree node hash structure
+      type tree_node = {
+        key: String,
+        title: String,
+        children: Array[tree_node],
+        disabled: bool,
+        selectable: bool,
+        checkable: bool,
+        disable_checkbox: bool,
+        icon: (String | Symbol)?,
+        switcher_icon: (String | Symbol)?,
+        async: bool,
+        loading: bool,
+        level: Integer,
+        parent_key: (String | nil),
+        leaf: bool,
+        is_leaf: bool
+      }
+
+      type switcher_config = {
+        default: (String | Symbol)
+      } | {
+        collapse: (String | Symbol),
+        expand: (String | Symbol)
+      }
+
+      @nodes: Array[Hash[Symbol, untyped]]
+      @checkable: bool
+      @selectable: bool
+      @disabled: bool
+      @default_expand_keys: Array[String]
+      @default_selected_keys: Array[String]
+      @default_checked_keys: Array[String]
+      @expanded_keys: (Array[String] | nil)
+      @selected_keys: (Array[String] | nil)
+      @checked_keys: (Array[String] | nil)
+      @show_line: bool
+      @switcher_icon: (String | Symbol)?
+      @icon: (String | Symbol)?
+      @directory: bool
+      @multiple: bool
+      @draggable: bool
+      @block_node: bool
+      @searchable: bool
+      @search_placeholder: String
+      @height: (Integer | String)?
+      @check_strictly: bool
+      @indent: Integer
+      @html_options: hakumi_html_options
+      @normalized_nodes: Array[tree_node]
+
+      # Class methods for controller integration
+      def self.extract_controller_locals: (Hash[Symbol, untyped] params) -> Hash[Symbol, untyped]
+      def self.parse_nodes: (untyped value) -> Array[untyped]
+      def self.parse_json_array: (untyped value, ?allow_nil: bool) -> (Array[untyped] | nil)
+      def self.boolean_param: (untyped value, ?default: bool) -> bool
+
+      def initialize: (
+        nodes: Array[Hash[Symbol, untyped]],
+        ?checkable: bool,
+        ?selectable: bool,
+        ?disabled: bool,
+        ?default_expand_keys: (Array[String | Integer] | String | Integer),
+        ?default_selected_keys: (Array[String | Integer] | String | Integer),
+        ?default_checked_keys: (Array[String | Integer] | String | Integer),
+        ?expanded_keys: (Array[String | Integer] | String | Integer | nil)?,
+        ?selected_keys: (Array[String | Integer] | String | Integer | nil)?,
+        ?checked_keys: (Array[String | Integer] | String | Integer | nil)?,
+        ?show_line: bool,
+        ?switcher_icon: (String | Symbol)?,
+        ?icon: (String | Symbol)?,
+        ?directory: bool,
+        ?multiple: bool,
+        ?draggable: bool,
+        ?block_node: bool,
+        ?searchable: bool,
+        ?search_placeholder: String,
+        ?height: (Integer | String)?,
+        ?check_strictly: bool,
+        ?indent: Integer,
+        **hakumi_html_options html_options
+      ) -> void
+
+      attr_reader normalized_nodes: Array[tree_node]
+
+      def wrapper_attributes: () -> hakumi_html_options
+      def list_attributes: () -> hakumi_html_options
+      def searchable?: () -> bool
+      def search_placeholder: () -> String
+      def render_node_template: () -> String
+      def render_indent: (Array[bool] level_mask) -> String
+      def render_nodes: (Array[tree_node] nodes, ?level_mask: Array[bool]) -> String
+      def wrapper_classes: () -> String
+      def list_classes: () -> String
+      def data_attributes: () -> hakumi_html_options
+
+      private
+
+      def validate_props!: () -> void
+      def normalize_nodes: (Array[Hash[Symbol, untyped]] nodes, ?parent_key: String?, ?level: Integer) -> Array[tree_node]
+      def render_node: (tree_node node, index: Integer, total: Integer, level_mask: Array[bool], has_next: bool) -> String
+      def node_classes: (tree_node node) -> String
+      def node_data: (tree_node node, index: Integer, total: Integer, has_next: bool) -> Hash[Symbol, untyped]
+      def node_aria: (tree_node node) -> Hash[Symbol, untyped]
+      def render_node_content_wrapper: (tree_node node) -> String
+      def render_switcher: (tree_node node) -> String
+      def normalize_switcher_conf: ((String | Symbol | Hash[Symbol, untyped]) icon_or_conf) -> (switcher_config | Hash[Symbol, untyped])
+      def render_checkbox: (tree_node node) -> (String | nil)
+      def render_icon: (tree_node node) -> (String | nil)
+      def render_title: (tree_node node) -> String
+      def render_node_children: (tree_node node, ?Array[bool] level_mask) -> (String | nil)
+      def switcher_classes: (bool is_leaf) -> String
+      def expanded?: (String key) -> bool
+      def selected?: (String key) -> bool
+      def checked?: (String key) -> bool
+      def half_checked?: (String _key) -> bool
+    end
+  end
+end

data/sig/hakumi/tree_select/component.rbs

@@ -0,0 +1,122 @@
+# frozen_string_literal: true
+
+module Hakumi
+  module TreeSelect
+    class Component < Hakumi::BaseComponent
+      include Hakumi::Concerns::FormField
+
+      type tree_select_status = nil | :error | :warning
+      type tree_node = {
+        key: String,
+        title: String,
+        children: Array[tree_node],
+        disabled: bool?,
+        selectable: bool?,
+        checkable: bool?,
+        disable_checkbox: bool?,
+        icon: hakumi_icon?,
+        switcher_icon: hakumi_icon?,
+        async: bool?,
+        loading: bool?
+      }
+
+      SIZES: Array[hakumi_size_standard]
+      VARIANTS: Array[hakumi_variant_select]
+      STATUSES: Array[tree_select_status]
+
+      @name: String
+      @options: Array[Hash[Symbol, untyped]]
+      @value: (String | Integer | Float | Array[String | Integer | Float])?
+      @placeholder: String
+      @multiple: bool
+      @tree_checkable: bool
+      @show_search: bool
+      @tree_default_expand_all: bool
+      @tree_selectable_leaf_only: bool
+      @disabled: bool
+      @allow_clear: bool
+      @size: hakumi_size_standard
+      @variant: hakumi_variant_select
+      @status: tree_select_status
+      @max_count: Integer?
+      @prefix: String?
+      @prefix_icon: hakumi_icon?
+      @label: String?
+      @caption: String?
+      @errors: Array[String]
+      @standalone: bool
+      @required: bool
+      @html_options: hakumi_html_options
+      @normalized_options: Array[tree_node]?
+
+      attr_reader prefix: String?
+      attr_reader prefix_icon: hakumi_icon?
+
+      def initialize: (
+        ?name: String?,
+        ?options: Array[Hash[Symbol, untyped]],
+        ?value: (String | Integer | Float | Array[String | Integer | Float])?,
+        ?placeholder: String,
+        ?multiple: bool,
+        ?tree_checkable: bool,
+        ?show_search: bool,
+        ?tree_default_expand_all: bool,
+        ?tree_selectable_leaf_only: bool,
+        ?disabled: bool,
+        ?allow_clear: bool,
+        ?size: hakumi_size_standard,
+        ?variant: hakumi_variant_select,
+        ?status: tree_select_status,
+        ?max_count: Integer?,
+        ?prefix: String?,
+        ?prefix_icon: hakumi_icon?,
+        ?label: String?,
+        ?caption: String?,
+        ?errors: (Array[String] | String)?,
+        ?standalone: bool,
+        ?required: bool,
+        **hakumi_html_options html_options
+      ) -> void
+
+      def wrapper_attributes: () -> hakumi_html_options
+
+      def has_prefix?: () -> bool
+
+      def empty_options?: () -> bool
+
+      def borderless?: () -> bool
+
+      def effective_status: () -> tree_select_status
+
+      def tree_component_options: () -> Hash[Symbol, untyped]
+
+      def input_value: () -> (String | Array[String])?
+
+      def display_label: () -> String?
+
+      def has_value?: () -> bool
+
+      private
+
+      def validate_props!: () -> void
+
+      def wrapper_classes: () -> String
+
+      def normalized_options: () -> Array[tree_node]
+
+      def normalize_options: (Array[Hash[Symbol, untyped]] options, ?parent_key: String?) -> Array[tree_node]
+
+      def selected_keys: () -> Array[String]
+
+      def multi_value?: () -> bool
+
+      def selected_labels: () -> Array[String]
+
+      def build_label_map: (Array[tree_node] options, ?Hash[String, String] map) -> Hash[String, String]
+
+      def default_expand_keys: () -> Array[String]
+
+      def collect_keys: (Array[tree_node] options, ?Array[String] keys) -> Array[String]
+    end
+  end
+end

data/sig/hakumi/typography/base_component.rbs

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+module Hakumi
+  module Typography
+    class BaseComponent < Hakumi::BaseComponent
+      type typography_type = :secondary | :success | :warning | :danger
+
+      TYPES: Array[typography_type]
+
+      @type: typography_type?
+      @disabled: bool
+      @mark: bool
+      @code: bool
+      @keyboard: bool
+      @underline: bool
+      @delete: bool
+      @strong: bool
+      @italic: bool
+      @copyable: bool
+      @copied_text: String
+      @copy_error_text: String
+      @html_options: hakumi_html_options
+
+      def initialize: (
+        ?type: typography_type?,
+        ?disabled: bool,
+        ?mark: bool,
+        ?code: bool,
+        ?keyboard: bool,
+        ?underline: bool,
+        ?delete: bool,
+        ?strong: bool,
+        ?italic: bool,
+        ?copyable: bool,
+        ?copied_text: String,
+        ?copy_error_text: String,
+        **hakumi_html_options html_options
+      ) -> void
+
+      def call: () -> String
+
+      private
+
+      def validate_props!: () -> void
+
+      def tag_name: () -> (String | Symbol)
+
+      def wrapper_classes: () -> String
+
+      def wrapper_attributes: () -> hakumi_html_options
+
+      def content_wrapper: () -> String
+
+      def copy_icon: () -> String
+    end
+  end
+end

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

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Hakumi
+  module Typography
+    module Link
+      class Component < BaseComponent
+        @href: String
+        @target: String?
+        @rel: String?
+
+        def initialize: (
+          href: String,
+          ?target: String?,
+          ?rel: String?,
+          **hakumi_html_options html_options
+        ) -> void
+
+        private
+
+        def tag_name: () -> Symbol
+
+        def wrapper_classes: () -> String
+
+        def wrapper_attributes: () -> hakumi_html_options
+      end
+    end
+  end
+end