hakumi_components 0.1.18.pre → 0.1.19.pre

data/sig/hakumi_components/table/concerns/columns.rbs

@@ -1,95 +0,0 @@
-# frozen_string_literal: true
-
-module HakumiComponents
-  module Table
-    module Concerns
-      # Column normalization and management for Table component
-      module Columns
-        # Column can be a hash config or a Symbol constant (SELECTION_COLUMN, EXPAND_COLUMN)
-        type column_like = Hash[Symbol, untyped] | Symbol
-        # Normalized column is a hash with specific keys (title, key, width, etc.) and dynamic values
-        type column_hash = Hash[Symbol, untyped]
-
-        # Get all leaf columns (columns without children)
-        def leaf_columns: () -> Array[column_hash]
-
-        # Count of leaf columns (minimum 1)
-        def leaf_column_count: () -> Integer
-
-        # Check if table has selection column
-        def selection_column?: () -> bool
-
-        # Check if table has expandable rows
-        def expandable?: () -> bool
-
-        # Check if table has expand column
-        def expand_column?: () -> bool
-
-        # Get normalized columns with special columns inserted
-        def normalized_columns: () -> Array[column_hash]
-
-        private
-
-        # Normalize an array of column definitions
-        def normalize_columns: (Array[column_like] columns) -> Array[column_hash]
-
-        # Normalize a single column definition
-        def normalize_column: (column_hash column) -> (column_hash | nil)
-
-        # Insert drag handle column if needed
-        def insert_drag_handle_column: (Array[column_hash] columns) -> Array[column_hash]
-
-        # Insert selection column if needed
-        def insert_selection_column: (Array[column_hash] columns) -> Array[column_hash]
-
-        # Insert expand column if needed
-        def insert_expand_column: (Array[column_hash] columns) -> Array[column_hash]
-
-        # Definition for selection column
-        def selection_column_definition: () -> column_hash
-
-        # Definition for expand column
-        def expand_column_definition: () -> column_hash
-
-        # Check if drag handle column should be added
-        def drag_handle_column?: () -> bool
-
-        # Definition for drag handle column
-        def drag_handle_column_definition: () -> column_hash
-
-        # Get first data column (non-special column)
-        def first_data_column: () -> (column_hash | nil)
-
-        # Recursively flatten all leaf columns
-        def flatten_leaf_columns: (Array[column_hash] columns) -> Array[column_hash]
-
-        # Count leaf columns recursively
-        def leaf_count: (Array[column_hash] columns) -> Integer
-
-        # Calculate maximum depth of column hierarchy
-        def max_depth: (Array[column_hash] columns, ?Integer depth) -> Integer
-
-        # Build header rows for rendering
-        def build_header_rows: (Array[column_hash] columns) -> Array[Array[column_hash]]
-
-        # Recursively build header rows
-        def build_rows_recursive: (Array[column_hash] columns, Integer level, Array[Array[column_hash]] rows, Integer max_depth) -> void
-
-        # Methods expected from Table::Component (via BaseComponent)
-        def columns_data: () -> Array[column_like]
-        def compute_fixed_offsets: (Array[column_hash] columns) -> void
-        def generate_id: (String prefix, ?length: Integer) -> String
-        # normalize_ellipsis_option: can be bool, hash, or string
-        def normalize_ellipsis_option: ((bool | Hash[Symbol, untyped] | String)? option) -> (Hash[Symbol, untyped] | nil)
-        # normalize_responsive_breakpoints: can be array or single value
-        def normalize_responsive_breakpoints: (untyped option) -> (Array[Symbol] | nil)
-        # dimension_to_css: accepts Numeric, String, or nil (from BaseComponent)
-        def dimension_to_css: ((Numeric | String)? value) -> String?
-        # normalize_column_editable: can be bool or hash with editable config
-        def normalize_column_editable: ((bool | Hash[Symbol, untyped])? value) -> (Hash[Symbol, untyped] | nil)
-        # normalize_should_cell_update: Symbol or String method name, returns String or nil
-        def normalize_should_cell_update: ((Symbol | String)? value) -> String?
-      end
-    end
-  end
-end

data/sig/hakumi_components/table/concerns/editable.rbs

@@ -1,40 +0,0 @@
-# frozen_string_literal: true
-
-module HakumiComponents
-  module Table
-    module Concerns
-      # Editable cell and row functionality for Table component
-      module Editable
-        EDITABLE_MODES: Array[Symbol]
-        EDITABLE_TRIGGERS: Array[Symbol]
-        EDITABLE_INPUT_TYPES: Array[Symbol]
-
-        # Returns JSON configuration for the table-level editable settings
-        def editable_config_json: () -> String?
-
-        private
-
-        # Normalizes the table-level editable configuration
-        def normalize_editable: (untyped value) -> untyped
-
-        # Normalizes column-level editable configuration
-        def normalize_column_editable: (untyped value) -> untyped
-
-        # Normalizes should_cell_update hook name
-        def normalize_should_cell_update: (untyped value) -> untyped
-
-        # Applies editable attributes to cell
-        def apply_editable_attributes!: (Hash[Symbol, untyped] attrs, Hash[Symbol, untyped] column) -> void
-
-        # Applies should_cell_update attributes to cell
-        def apply_should_cell_update_attributes!: (Hash[Symbol, untyped] attrs, Hash[Symbol, untyped] column) -> void
-
-        # Returns the editable payload for a specific cell/column
-        def cell_editable_payload: (Hash[Symbol, untyped] column) -> untyped
-
-        # Instance variable from Table::Component
-        @editable: untyped
-      end
-    end
-  end
-end

data/sig/hakumi_components/table/concerns/ellipsis.rbs

@@ -1,27 +0,0 @@
-# frozen_string_literal: true
-
-module HakumiComponents
-  module Table
-    module Concerns
-      # Text ellipsis and tooltip handling for Table cells
-      module Ellipsis
-        private
-
-        # Get ellipsis config from column
-        def ellipsis_config: (Hash[Symbol, untyped] column) -> untyped
-
-        # Normalize ellipsis option
-        def normalize_ellipsis_option: (untyped option) -> untyped
-
-        # Normalize ellipsis tooltip option
-        def normalize_ellipsis_tooltip_option: (untyped option) -> untyped
-
-        # Get ellipsis title for cell
-        def ellipsis_title: (untyped config, untyped raw_value, untyped content_fragment) -> untyped
-
-        # Get ellipsis tooltip component for cell
-        def ellipsis_tooltip_component: (untyped config, untyped raw_value, untyped row, Integer row_index) -> untyped
-      end
-    end
-  end
-end

data/sig/hakumi_components/table/concerns/fixed_columns.rbs

@@ -1,33 +0,0 @@
-# frozen_string_literal: true
-
-module HakumiComponents
-  module Table
-    module Concerns
-      # Fixed (sticky) column positioning for Table component
-      module FixedColumns
-        # Check if table has any fixed columns
-        def fixed_columns?: () -> bool
-
-        private
-
-        # Get or initialize fixed offsets hash
-        def fixed_offsets: () -> Hash[untyped, untyped]
-
-        # Applies fixed column positioning attributes to cell
-        def apply_fixed_column_attributes!: (Hash[Symbol, untyped] attrs, Hash[Symbol, untyped] column, ?header: bool) -> void
-
-        # Compute fixed column offsets from left and right
-        def compute_fixed_offsets: (Array[Hash[Symbol, untyped]] leaf_columns) -> void
-
-        # Get width for fixed column (must be defined)
-        def fixed_column_width!: (Hash[Symbol, untyped] column) -> untyped
-
-        # Convert width value to numeric
-        def numeric_width: (untyped value) -> untyped
-
-        # Instance variable for fixed offsets
-        @fixed_offsets: Hash[untyped, untyped]
-      end
-    end
-  end
-end

data/sig/hakumi_components/tabs/component.rbs

@@ -1,66 +0,0 @@
-# frozen_string_literal: true
-
-module HakumiComponents
-  module Tabs
-    class Component < HakumiComponents::BaseComponent
-      type tab_type = :line | :card | :editable_card
-      type tab_size = :large | :middle | :small
-      type tab_position = :top | :bottom | :left | :right
-      type indicator_align = :start | :center | :end
-
-      TYPES: Array[tab_type]
-      SIZES: Array[tab_size]
-      TAB_POSITIONS: Array[tab_position]
-      INDICATOR_ALIGNS: Array[indicator_align]
-
-      @active_key: String?
-      @default_active_key: String?
-      @type: tab_type
-      @size: tab_size
-      @tab_position: tab_position
-      @centered: bool
-      @animated: bool
-      @indicator: hakumi_html_options?
-      @tab_bar_gutter: Integer?
-      @tab_bar_extra_content_left: String?
-      @tab_bar_extra_content_right: String?
-      @add_icon: String?
-      @hide_add: bool
-      @more_icon: String?
-      @html_options: hakumi_html_options
-
-      def initialize: (
-        ?active_key: String?,
-        ?default_active_key: String?,
-        ?type: tab_type,
-        ?size: tab_size,
-        ?tab_position: tab_position,
-        ?centered: bool,
-        ?animated: bool,
-        ?indicator: hakumi_html_options?,
-        ?tab_bar_gutter: Integer?,
-        ?tab_bar_extra_content_left: String?,
-        ?tab_bar_extra_content_right: String?,
-        ?add_icon: String?,
-        ?hide_add: bool,
-        ?more_icon: String?,
-        **hakumi_html_options html_options
-      ) -> void
-
-      def call: () -> String
-
-      def before_render: () -> void
-
-      private
-
-      def validate_props!: () -> void
-      def wrapper_classes: () -> String
-      def wrapper_attributes: () -> hakumi_html_options
-      def render_tab_bar: () -> String
-      def render_content: () -> String
-      def tab_bar_classes: () -> String
-      def tabs_nav_classes: () -> String
-      def indicator_style: () -> String
-    end
-  end
-end

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

@@ -1,29 +0,0 @@
-# frozen_string_literal: true
-
-module HakumiComponents
-  module Tabs
-    module Item
-      class Component < HakumiComponents::BaseComponent
-        @key: (String | Symbol)
-        @label: String?
-        @disabled: bool
-        @closable: bool
-        @icon: hakumi_icon?
-        @html_options: hakumi_html_options
-
-        def initialize: (
-          key: (String | Symbol),
-          ?label: String?,
-          ?disabled: bool,
-          ?closable: bool,
-          ?icon: hakumi_icon?,
-          **hakumi_html_options html_options
-        ) -> void
-
-        attr_reader key: (String | Symbol)
-
-        def call: () -> String
-      end
-    end
-  end
-end

data/sig/hakumi_components/tag/component.rbs

@@ -1,86 +0,0 @@
-# frozen_string_literal: true
-
-module HakumiComponents
-  module Tag
-    class Component < HakumiComponents::BaseComponent
-      type tag_color_preset = :magenta | :red | :volcano | :orange | :gold | :lime | :green | :cyan | :blue | :geekblue | :purple
-      type tag_status = :success | :processing | :error | :default | :warning
-      type tag_variant = :filled | :outlined | :borderless
-      type tag_color = tag_color_preset | tag_status | String
-
-      COLORS: Array[tag_color_preset]
-      STATUSES: Array[tag_status]
-      VARIANTS: Array[tag_variant]
-
-      # Extracts locals from controller params for dynamic rendering
-      def self.extract_controller_locals: (untyped params) -> Hash[Symbol, untyped]
-
-      @color: tag_color?
-      @closable: bool
-      @close_icon: hakumi_icon?
-      @bordered: bool
-      @variant: tag_variant
-      @href: String?
-      @checkable: bool
-      @checked: bool
-      @draggable: bool
-      @html_options: hakumi_html_options
-
-      def initialize: (
-        ?color: tag_color?,
-        ?closable: bool?,
-        ?close_icon: hakumi_icon?,
-        ?bordered: bool?,
-        ?variant: tag_variant?,
-        ?href: String?,
-        ?checkable: bool?,
-        ?checked: bool?,
-        ?draggable: bool?,
-        **hakumi_html_options html_options
-      ) -> void
-
-      def call: () -> String
-
-      # Slot for icon content
-      def icon: () -> String?
-      def icon?: () -> bool
-      def icon=: (String) -> void
-
-      private
-
-      def validate_props!: () -> void
-
-      def render_link_tag: () -> String
-
-      def render_span_tag: () -> String
-
-      def tag_content: () -> String
-
-      def icon_element: () -> String?
-
-      def content_wrapper: () -> String?
-
-      def close_button: () -> String?
-
-      def tag_attributes: () -> hakumi_html_options
-
-      def tag_classes: () -> String
-
-      def tag_data_attributes: () -> hakumi_html_options
-
-      def preset_color?: () -> bool
-
-      def preset_color: () -> Symbol?
-
-      def status_color?: () -> bool
-
-      def status_color: () -> Symbol?
-
-      def custom_color?: () -> bool
-
-      def custom_color_styles: () -> String?
-
-      def contrast_color: (String hex_color) -> String
-    end
-  end
-end

data/sig/hakumi_components/tag/group/component.rbs

@@ -1,24 +0,0 @@
-# frozen_string_literal: true
-
-module HakumiComponents
-  module Tag
-    module Group
-      class Component < HakumiComponents::BaseComponent
-        @sortable: bool
-        @animation: Integer
-        @html_options: hakumi_html_options
-
-        def initialize: (?sortable: bool, ?animation: Integer, **hakumi_html_options html_options) -> void
-
-        def call: () -> String
-
-        private
-
-        def tag_group_attributes: () -> hakumi_html_options
-        def tag_group_classes: () -> String
-        # Returns data attributes hash with controller, sortable_value, animation_value
-        def tag_group_data: () -> Hash[Symbol, (String | bool | Integer)]
-      end
-    end
-  end
-end

data/sig/hakumi_components/time_picker/component.rbs

@@ -1,72 +0,0 @@
-# frozen_string_literal: true
-
-module HakumiComponents
-  module TimePicker
-    class Component < HakumiComponents::BaseComponent
-      include HakumiComponents::Concerns::FormField
-
-      type time_variant = :default | :borderless | :filled
-      type time_value = String | Time | DateTime | nil
-
-      SIZES: Array[hakumi_size_standard]
-      VARIANTS: Array[time_variant]
-
-      @name: String
-      @label: String?
-      @caption: String?
-      @value: time_value
-      @default_value: time_value
-      @format: String
-      @hour_step: Integer
-      @minute_step: Integer
-      @second_step: Integer
-      @use_12_hours: bool
-      @show_now: bool
-      @disabled: bool
-      @allow_clear: bool
-      @placeholder: String?
-      @size: hakumi_size_standard
-      @variant: time_variant
-      @errors: Array[String]
-      @standalone: bool
-      @required: bool
-      @html_options: hakumi_html_options
-
-      def initialize: (
-        ?name: String?,
-        ?label: String?,
-        ?caption: String?,
-        ?value: time_value,
-        ?default_value: time_value,
-        ?format: String,
-        ?hour_step: Integer,
-        ?minute_step: Integer,
-        ?second_step: Integer,
-        ?use_12_hours: bool,
-        ?show_now: bool,
-        ?disabled: bool,
-        ?allow_clear: bool,
-        ?placeholder: String?,
-        ?size: hakumi_size_standard,
-        ?variant: time_variant,
-        ?errors: (Array[String] | String),
-        ?standalone: bool,
-        **hakumi_html_options html_options
-      ) -> void
-
-      private
-
-      def validate_props!: () -> void
-      def current_value: () -> time_value
-      def show_seconds?: () -> bool
-      def wrapper_classes: () -> String
-      def wrapper_attributes: () -> hakumi_html_options
-      def input_attributes: () -> hakumi_html_options
-      def step_value: (untyped value) -> Integer
-      def formatted_hours: () -> Array[String]
-      def formatted_minutes: () -> Array[String]
-      def formatted_seconds: () -> Array[String]
-      def period_options: () -> Array[String]
-    end
-  end
-end

data/sig/hakumi_components/timeline/component.rbs

@@ -1,61 +0,0 @@
-# frozen_string_literal: true
-
-module HakumiComponents
-  module Timeline
-    class Component < HakumiComponents::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_components/timeline/item/component.rbs

@@ -1,70 +0,0 @@
-# frozen_string_literal: true
-
-module HakumiComponents
-  module Timeline
-    module Item
-      class Component < HakumiComponents::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_components/tooltip/component.rbs

@@ -1,73 +0,0 @@
-# frozen_string_literal: true
-
-module HakumiComponents
-  module Tooltip
-    class Component < HakumiComponents::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