hakumi_components 0.1.3.pre

data/sig/hakumi/qr_code/component.rbs

@@ -0,0 +1,111 @@
+# frozen_string_literal: true
+
+module Hakumi
+  module QrCode
+    class Component < Hakumi::BaseComponent
+      type qr_code_type = :canvas | :svg
+      type qr_code_status = :active | :expired | :loading | :scanned
+      type qr_code_error_level = :L | :M | :Q | :H
+
+      TYPES: Array[qr_code_type]
+      STATUSES: Array[qr_code_status]
+      ERROR_LEVELS: Array[qr_code_error_level]
+
+      @value: String
+      @size: Integer
+      @type: qr_code_type
+      @color: String?
+      @bg_color: String?
+      @icon_input: untyped
+      @icon_size: Integer
+      @icon_component: untyped
+      @icon_url: String?
+      @status: qr_code_status
+      @status_render: untyped
+      @bordered: bool
+      @error_level: qr_code_error_level
+      @download_name: String?
+      @aria_label: String?
+      @html_options: hakumi_html_options
+
+      def self.extract_controller_locals: (untyped params) -> Hash[Symbol, untyped]
+
+      def self.parse_number: (untyped value) -> Numeric?
+
+      def self.parse_error_level: (untyped value) -> Symbol?
+
+      def initialize: (
+        value: String,
+        ?size: Integer,
+        ?type: qr_code_type,
+        ?color: String?,
+        ?bg_color: String?,
+        ?icon: untyped,
+        ?icon_size: Integer,
+        ?status: qr_code_status,
+        ?status_render: untyped,
+        ?bordered: bool,
+        ?error_level: qr_code_error_level,
+        ?download_name: String?,
+        ?aria_label: String?,
+        **hakumi_html_options html_options
+      ) -> void
+
+      def wrapper_attributes: () -> hakumi_html_options
+
+      def renderer_attributes: () -> hakumi_html_options
+
+      def icon?: () -> bool
+
+      def icon_markup: () -> String?
+
+      def icon_image_attributes: () -> hakumi_html_options
+
+      def status_overlay?: () -> bool
+
+      def status_overlay_markup: () -> String?
+
+      def status_text: () -> String
+
+      def status_description: () -> String?
+
+      private
+
+      def validate_props!: () -> void
+
+      def wrapper_classes: () -> String
+
+      def wrapper_styles: () -> String
+
+      def size_css_value: () -> String?
+
+      def icon_css_value: () -> String?
+
+      def resolve_icon!: () -> void
+
+      def icon_component?: () -> bool
+
+      def icon_image?: () -> bool
+
+      def data_attributes: () -> hakumi_html_options
+
+      def loading?: () -> bool
+
+      def custom_status_render?: () -> bool
+
+      def custom_status_overlay: () -> untyped
+
+      def default_status_overlay: () -> String
+
+      def normalize_symbol: (untyped value) -> Symbol?
+
+      def normalize_error_level: (untyped value) -> Symbol?
+
+      def normalize_string: (untyped value) -> String?
+
+      def extract_icon_name: (untyped value) -> Symbol?
+
+      def icon_component_size: () -> Integer
+    end
+  end
+end

data/sig/hakumi/radio/component.rbs

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+module Hakumi
+  module Radio
+    class Component < Hakumi::BaseComponent
+      include Hakumi::Concerns::FormField
+
+      SIZES: Array[hakumi_size_standard]
+
+      @name: String
+      @value: (String | Integer | Float)?
+      @text: String?
+      @label: String?
+      @caption: String?
+      @checked: bool
+      @disabled: bool
+      @size: hakumi_size_standard
+      @id: String
+      @auto_focus: bool
+      @required: bool
+      @standalone: bool
+      @errors: Array[String]
+      @html_options: hakumi_html_options
+
+      def initialize: (
+        name: String,
+        ?value: (String | Integer | Float)?,
+        ?text: String?,
+        ?label: String?,
+        ?caption: String?,
+        ?checked: bool,
+        ?disabled: bool,
+        ?size: hakumi_size_standard,
+        ?id: String?,
+        ?auto_focus: bool,
+        ?required: bool,
+        ?standalone: bool,
+        ?errors: (Array[String] | String)?,
+        **hakumi_html_options html_options
+      ) -> void
+
+      def wrapper_classes: () -> String
+
+      def radio_classes: () -> String
+
+      def data_controllers: () -> String
+
+      def label_text: () -> String?
+
+      private
+
+      def validate_props!: () -> void
+    end
+  end
+end

data/sig/hakumi/radio/group/component.rbs

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+module Hakumi
+  module Radio
+    module Group
+      class Component < Hakumi::BaseComponent
+        include Hakumi::Concerns::FormField
+
+        type radio_variant = :default | :button | :solid
+        type radio_direction = :horizontal | :vertical
+        type radio_option = { label: String, value: (String | Integer | Float), disabled: bool }
+
+        SIZES: Array[hakumi_size_standard]
+        VARIANTS: Array[radio_variant]
+        DIRECTIONS: Array[radio_direction]
+
+        @name: String
+        @value: (String | Integer | Float)?
+        @options: Array[radio_option]
+        @label: String?
+        @caption: String?
+        @variant: radio_variant
+        @direction: radio_direction
+        @size: hakumi_size_standard
+        @disabled: bool
+        @standalone: bool
+        @required: bool
+        @errors: Array[String]
+        @html_options: hakumi_html_options
+
+        def initialize: (
+          ?name: String?,
+          ?value: (String | Integer | Float)?,
+          ?options: Array[Hash[Symbol, untyped] | String],
+          ?label: String?,
+          ?caption: String?,
+          ?variant: radio_variant,
+          ?direction: radio_direction,
+          ?size: hakumi_size_standard,
+          ?disabled: bool,
+          ?standalone: bool,
+          ?required: bool,
+          ?errors: (Array[String] | String)?,
+          **hakumi_html_options html_options
+        ) -> void
+
+        def wrapper_attributes: () -> hakumi_html_options
+
+        def normalized_options: () -> Array[radio_option]
+
+        def option_checked?: ((String | Integer | Float) option_value) -> bool
+
+        def option_disabled?: (radio_option option) -> bool
+
+        def button_wrapper_classes: (radio_option option) -> String
+
+        def option_id: (Integer index) -> String
+
+        def button_group?: () -> bool
+
+        private
+
+        def wrapper_classes: () -> String
+
+        def normalize_options: (Array[Hash[Symbol, untyped] | String] options) -> Array[radio_option]
+
+        def validate_props!: () -> void
+      end
+    end
+  end
+end

data/sig/hakumi/rate/component.rbs

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+module Hakumi
+  module Rate
+    class Component < Hakumi::BaseComponent
+      include Hakumi::Concerns::FormField
+
+      type star_state = :full | :half | :zero
+
+      @name: String
+      @label: String?
+      @caption: String?
+      @value: untyped
+      @default_value: Numeric
+      @count: Integer
+      @allow_half: bool
+      @allow_clear: bool
+      @disabled: bool
+      @readonly: bool
+      @tooltips: Array[String]
+      @character: String?
+      @required: bool
+      @standalone: bool
+      @errors: Array[String]
+      @html_options: hakumi_html_options
+
+      def initialize: (
+        ?name: String?,
+        ?label: String?,
+        ?caption: String?,
+        ?value: untyped,
+        ?default_value: Numeric,
+        ?count: Integer,
+        ?allow_half: bool,
+        ?allow_clear: bool,
+        ?disabled: bool,
+        ?readonly: bool,
+        ?tooltips: Array[String],
+        ?character: String?,
+        ?required: bool,
+        ?standalone: bool,
+        ?errors: (Array[String] | String),
+        **hakumi_html_options html_options
+      ) -> void
+
+      def current_value: () -> Float
+      def rate_classes: () -> String
+      def rate_wrapper_attributes: () -> hakumi_html_options
+      def star_state: (Integer index) -> star_state
+      def star_classes: (star_state state) -> String
+      def tooltip_for: (Integer index) -> String?
+      def character_content: () -> String?
+      def input_attributes: () -> hakumi_html_options
+    end
+  end
+end

data/sig/hakumi/result/component.rbs

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+module Hakumi
+  module Result
+    class Component < Hakumi::BaseComponent
+      type result_status = :success | :info | :warning | :error
+
+      STATUSES: Array[String]
+      DEFAULT_TITLES: Hash[String, String]
+      DEFAULT_ICON_NAME: String
+      STATUS_ICON_MAP: Hash[String, Hash[Symbol, (String | Symbol)]]
+      STATUS_ICON_SIZE: Integer
+
+      # Extracts locals from controller params for dynamic rendering
+      # Params is typically ActionController::Parameters but we use untyped for flexibility
+      def self.extract_controller_locals: (untyped params) -> Hash[Symbol, untyped]
+
+      @status: String
+      @title: String?
+      @sub_title: String?
+      @icon: (hakumi_icon | false)?
+      @extra: untyped  # Can be String, ViewComponent, or any renderable content
+      @html_options: hakumi_html_options
+
+      def initialize: (
+        ?status: result_status?,
+        ?title: String?,
+        ?sub_title: String?,
+        ?icon: (hakumi_icon | false)?,
+        ?extra: untyped,  # Extra content slot - can be any renderable
+        **hakumi_html_options html_options
+      ) -> void
+
+      def wrapper_attributes: () -> hakumi_html_options
+
+      def icon_present?: () -> bool
+
+      def icon_content: () -> String?
+
+      def title_content: () -> String?
+
+      def sub_title_content: () -> String?
+
+      def extra_content: () -> String?
+
+      def content_present?: () -> bool
+
+      def extra_present?: () -> bool
+
+      def title_present?: () -> bool
+
+      def sub_title_present?: () -> bool
+
+      private
+
+      def validate_props!: () -> void
+
+      def wrapper_classes: () -> String
+
+      def status_icon_component: () -> Hakumi::Icon::Component?
+
+      def default_icon: () -> String
+    end
+  end
+end

data/sig/hakumi/segmented/component.rbs

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+module Hakumi
+  module Segmented
+    class Component < Hakumi::BaseComponent
+      # Segmented option hash structure
+      type segmented_option = {
+        label: (String | untyped),  # String or ViewComponent
+        value: (String | Integer | Symbol),
+        disabled: bool,
+        icon: (String | Symbol | untyped)?,  # String, Symbol, or ViewComponent
+        class_name: String?,
+        aria_label: String?
+      }
+
+      SIZES: Array[hakumi_size_standard]
+
+      @options: Array[segmented_option]
+      @value: (String | nil)
+      @disabled: bool
+      @block: bool
+      @vertical: bool
+      @round: bool
+      @name: String
+      @size: hakumi_size_standard
+      @aria_label: (String | nil)
+      @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_options_param: (untyped options) -> untyped
+      def self.truthy_param?: (untyped value) -> bool
+
+      def initialize: (
+        ?options: Array[untyped],
+        ?value: (String | Integer | Symbol)?,
+        ?default_value: (String | Integer | Symbol)?,
+        ?disabled: bool,
+        ?block: bool,
+        ?vertical: bool,
+        ?round: bool,
+        ?name: String?,
+        ?size: hakumi_size_standard,
+        ?aria_label: String?,
+        **hakumi_html_options html_options
+      ) -> void
+
+      def wrapper_attributes: () -> hakumi_html_options
+      def normalized_options: () -> Array[segmented_option]
+      def option_classes: (segmented_option option) -> String
+      def option_data_attributes: (segmented_option option) -> hakumi_html_options
+      def option_input_attributes: (segmented_option option, Integer index) -> hakumi_html_options
+      def option_selected?: (segmented_option option) -> bool
+      def option_disabled?: (segmented_option option) -> bool
+      def option_id: (Integer index) -> String
+      def option_label: (segmented_option option) -> (String | nil)
+      def option_icon: (segmented_option option) -> (String | nil)
+
+      private
+
+      def validate_props!: () -> void
+      def wrapper_classes: () -> String
+      def normalize_options: (Array[untyped] options) -> Array[segmented_option]
+      def option_aria_label: (segmented_option option) -> (String | nil)
+      def icon_only_option?: (segmented_option option) -> bool
+      def data_attributes: () -> hakumi_html_options
+      def normalize_value: ((String | Integer | Symbol)? value, (String | Integer | Symbol)? default_value) -> (String | nil)
+      def normalize_size: ((String | Symbol)? size) -> (Symbol | nil)
+      def cast_boolean: (untyped value) -> bool
+      def normalize_string: (untyped value) -> (String | nil)
+    end
+  end
+end

data/sig/hakumi/select/component.rbs

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+module Hakumi
+  module Select
+    class Component < Hakumi::BaseComponent
+      include Hakumi::Concerns::FormField
+
+      type select_option = [String, (String | Integer | Float)]
+
+      SIZES: Array[hakumi_size_standard]
+      VARIANTS: Array[hakumi_variant_select]
+      TRIGGERS: Array[hakumi_trigger]
+
+      @name: String
+      @options: Array[select_option | String | Integer]
+      @label: String?
+      @caption: String?
+      @value: (String | Integer | Float)?
+      @placeholder: String?
+      @size: hakumi_size_standard
+      @variant: hakumi_variant_select
+      @trigger: hakumi_trigger
+      @icon: hakumi_icon?
+      @disabled: bool
+      @required: bool
+      @allow_clear: bool
+      @show_search: bool
+      @standalone: bool
+      @errors: Array[String]
+      @html_options: hakumi_html_options
+
+      attr_reader variant: hakumi_variant_select
+      attr_reader trigger: hakumi_trigger
+      attr_reader icon: hakumi_icon?
+
+      def initialize: (
+        ?name: String?,
+        ?options: Array[select_option | String | Integer],
+        ?label: String?,
+        ?caption: String?,
+        ?value: (String | Integer | Float)?,
+        ?placeholder: String?,
+        ?size: hakumi_size_standard,
+        ?variant: hakumi_variant_select,
+        ?trigger: hakumi_trigger,
+        ?icon: hakumi_icon?,
+        ?disabled: bool,
+        ?required: bool,
+        ?allow_clear: bool,
+        ?show_search: bool,
+        ?standalone: bool,
+        ?errors: (Array[String] | String)?,
+        **hakumi_html_options html_options
+      ) -> void
+
+      private
+
+      def validate_props!: () -> void
+
+      def select_wrapper_classes: () -> String
+
+      def borderless?: () -> bool
+
+      def hover_trigger?: () -> bool
+
+      def wrapper_attributes: () -> hakumi_html_options
+
+      def selected_label: () -> (String | Integer | Float)?
+
+      def formatted_options: () -> Array[select_option]
+    end
+  end
+end

data/sig/hakumi/skeleton/avatar/component.rbs

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Hakumi
+  module Skeleton
+    module Avatar
+      class Component < Hakumi::BaseComponent
+        @shape: Symbol
+        @size: (Symbol | Integer)
+        @active: bool
+        @html_options: hakumi_html_options
+
+        def initialize: (?shape: Symbol, ?size: (Symbol | Integer), ?active: bool, **hakumi_html_options html_options) -> void
+
+        def call: () -> String
+
+        private
+
+        def wrapper_classes: () -> String
+        def wrapper_attributes: () -> hakumi_html_options
+      end
+    end
+  end
+end

data/sig/hakumi/skeleton/button/component.rbs

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Hakumi
+  module Skeleton
+    module Button
+      class Component < Hakumi::BaseComponent
+        @shape: Symbol
+        @size: (Symbol | Integer)
+        @active: bool
+        @block: bool
+        @html_options: hakumi_html_options
+
+        def initialize: (?shape: Symbol, ?size: (Symbol | Integer), ?active: bool, ?block: bool, **hakumi_html_options html_options) -> void
+
+        def call: () -> String
+
+        private
+
+        def wrapper_classes: () -> String
+        def wrapper_attributes: () -> hakumi_html_options
+      end
+    end
+  end
+end

data/sig/hakumi/skeleton/component.rbs

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+module Hakumi
+  module Skeleton
+    class Component < Hakumi::BaseComponent
+      type skeleton_avatar_size = :small | :default | :large
+      type skeleton_avatar_shape = :circle | :square
+      type skeleton_config = Hash[Symbol, untyped]
+
+      AVATAR_SIZES: Array[skeleton_avatar_size]
+      AVATAR_SHAPES: Array[skeleton_avatar_shape]
+      DEFAULT_PARAGRAPH_ROWS: Integer
+
+      # Extracts locals from controller params for dynamic rendering
+      def self.extract_controller_locals: (untyped params) -> Hash[Symbol, untyped]
+
+      def self.normalize_config_param: (untyped value) -> (skeleton_config | bool)?
+
+      @loading: bool
+      @active: bool
+      @round: bool
+      @avatar: skeleton_config?
+      @title: skeleton_config?
+      @paragraph: skeleton_config?
+      @html_options: hakumi_html_options
+
+      def initialize: (
+        ?loading: bool,
+        ?active: bool,
+        ?avatar: skeleton_config | bool,
+        ?title: skeleton_config | bool,
+        ?paragraph: skeleton_config | bool,
+        ?round: bool,
+        **hakumi_html_options html_options
+      ) -> void
+
+      def loading?: () -> bool
+
+      def wrapper_attributes: () -> hakumi_html_options
+
+      def avatar?: () -> bool
+
+      def title?: () -> bool
+
+      def paragraph?: () -> bool
+
+      def avatar_classes: () -> String
+
+      def avatar_style: () -> String?
+
+      def title_style: () -> String?
+
+      def paragraph_row_widths: () -> Array[String]
+
+      def paragraph_row_style: (String? width) -> String?
+
+      def paragraph_rows: () -> Integer
+
+      private
+
+      def normalize_config: (untyped value) -> skeleton_config?
+
+      def wrapper_classes: () -> String
+
+      def avatar_size: () -> (skeleton_avatar_size | Numeric)
+
+      def avatar_shape: () -> skeleton_avatar_shape
+
+      def default_paragraph_widths: (Integer rows) -> Array[String]
+
+      def validate_props!: () -> void
+
+      def validate_inclusion_value: (Symbol name, untyped value, Array[untyped] allowed) -> void
+    end
+  end
+end

data/sig/hakumi/skeleton/image/component.rbs

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Hakumi
+  module Skeleton
+    module Image
+      class Component < Hakumi::BaseComponent
+        @shape: Symbol
+        @active: bool
+        @html_options: hakumi_html_options
+
+        def initialize: (?shape: Symbol, ?active: bool, **hakumi_html_options html_options) -> void
+
+        def call: () -> String
+
+        private
+
+        def wrapper_classes: () -> String
+        def wrapper_attributes: () -> hakumi_html_options
+      end
+    end
+  end
+end

data/sig/hakumi/skeleton/input/component.rbs

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Hakumi
+  module Skeleton
+    module Input
+      class Component < Hakumi::BaseComponent
+        @size: (Symbol | Integer)
+        @active: bool
+        @block: bool
+        @html_options: hakumi_html_options
+
+        def initialize: (?size: (Symbol | Integer), ?active: bool, ?block: bool, **hakumi_html_options html_options) -> void
+
+        def call: () -> String
+
+        private
+
+        def wrapper_classes: () -> String
+        def wrapper_attributes: () -> hakumi_html_options
+      end
+    end
+  end
+end

data/sig/hakumi/skeleton/node/component.rbs

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Hakumi
+  module Skeleton
+    module Node
+      class Component < Hakumi::BaseComponent
+        @active: bool
+        @html_options: hakumi_html_options
+
+        def initialize: (?active: bool, **hakumi_html_options html_options) -> void
+
+        def call: () -> String
+
+        private
+
+        def wrapper_classes: () -> String
+        def wrapper_attributes: () -> hakumi_html_options
+      end
+    end
+  end
+end