odt-ui-rails 2.0.1 → 2.2.0

data/lib/odt_ui/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module OdtUi
-  VERSION = "2.0.1"
+  VERSION = "2.2.0"
 end

data/sig/odt_ui.rbs

@@ -2,87 +2,220 @@ module OdtUi
   VERSION: String
 
   module Helper
-    type button_variant = :filled | :light | :outline | :subtle | :ghost | String
-    type button_color = :primary | :secondary | :success | :warning | :danger | :neutral | String
+    type button_variant = :filled | :frosted | :capsule | :ghost | :light | :outline | :outlined | :subtle | String
+    type button_color = :primary | :secondary | :surface | :muted | :inverse | :success | :warning | :danger | :info | :neutral | String
     type button_size = :xs | :sm | :md | :lg | :xl | String
     type radius_size = :none | :xs | :sm | :md | :lg | :xl | :"2xl" | :"3xl" | :"4xl" | :full | Symbol | String
+    type shadow_size = :none | :card | :dropdown | :modal | :popover | Symbol | String
 
-    type badge_variant = :subtle | :filled | :outline | String
+    type badge_variant = :subtle | :filled | :outlined | :outline | String
     type badge_color = :primary | :secondary | :success | :warning | :danger | :info | :neutral | String
     type badge_size = :sm | :md | String
 
-    type card_variant = :elevated | :frosted | :subtle | :muted | :outlined | String
+    type card_variant = :elevated | :outlined | :subtle | :muted | :ghost | :frosted | String
+    type card_background = :base | :surface | :surface_elevated | :surface_muted | :surface_subtle | :gradient_primary | :gradient_secondary | :gradient_vibrant | :gradient_hero | :frosted | :frosted_muted | :frosted_subtle | :frosted_gradient_primary | :frosted_gradient_secondary | :transparent | Symbol | String
+    type card_border = :none | :muted | :base | :strong | :primary | :secondary | :danger | :success | bool | Symbol | String
+    type card_padding = :none | :xs | :sm | :md | :lg | :xl | :"2xl" | Symbol | String
+    type card_tag = :div | :article | :section | :aside | :main | Symbol | String
+
     type alert_variant = :success | :warning | :danger | :info | String
-    type heading_tag = :h1 | :h2 | :h3 | :h4 | :h5 | String
-    type text_color = :default | :strong | :muted | :subtle | :primary | String
-    type text_size = :xs | :sm | :base | :lg | String
-    type avatar_size = :xs | :sm | :md | :lg | :xl | String
+    type heading_tag = :h1 | :h2 | :h3 | :h4 | :h5 | :h6 | String
+    type heading_size = :"5xl" | :"4xl" | :"3xl" | :"2xl" | :xl | :lg | Symbol | String
+    type font_weight = :light | :normal | :medium | :semibold | :bold | :extrabold | Symbol | String
+    type typography_color = :strong | :default | :muted | :subtle | :disabled | :primary | :secondary | :success | :warning | :danger | :info | Symbol | String
+
+    type text_tag = :p | :span | :div | :label | :small | Symbol | String
+    type text_size = :xs | :sm | :base | :lg | :xl | :"2xl" | Symbol | String
+
+    type avatar_size = :xs | :sm | :md | :lg | :xl | :"2xl" | String
     type avatar_color = :secondary | :primary | :neutral | String
 
+    type input_variant = :outlined | :filled | :frosted | String
+    type input_size = :sm | :md | :lg | String
+    type input_resize = :none | :vertical | :horizontal | :both | String
+    type checkbox_color = :primary | :secondary | :success | :warning | :danger | :dark | :neutral | String
+    type checkbox_size = :sm | :md | :lg | String
+
     # Renders an ODT Button component.
-    #
-    # @param text [String, nil] Button label text
-    # @param variant [:filled, :light, :outline, :subtle, :ghost] Button style variant (default: :filled)
-    # @param color [:primary, :secondary, :success, :warning, :danger, :neutral] Button theme color (default: :primary)
-    # @param size [:xs, :sm, :md, :lg, :xl] Size of the button (default: :md)
-    # @param radius [:none, :xs, :sm, :md, :lg, :xl, :"2xl", :"3xl", :"4xl", :full] Border radius (default: :full)
-    # @param href [String, nil] URL if rendering as an anchor link <a>
-    # @param icon [String, nil] Icon class (e.g. 'fa-solid fa-plus') or SVG string
-    # @param right_icon [String, nil] Right icon class or SVG string
-    # @param full_width [bool] Stretch button to 100% width (default: false)
-    # @param disabled [bool] Disabled state (default: false)
-    # @param type [String] Button type attribute (default: "button")
-    def odt_button: (?String? text, ?variant: button_variant, ?color: button_color, ?size: button_size, ?radius: radius_size, ?href: String?, ?icon: String?, ?right_icon: String?, ?full_width: bool, ?disabled: bool, ?type: String, **untyped) ?{ () -> untyped } -> untyped
+    def odt_button: (
+      ?String? text,
+      ?variant: button_variant,
+      ?color: button_color,
+      ?size: button_size,
+      ?radius: radius_size?,
+      ?shadow: shadow_size?,
+      ?icon_only: bool,
+      ?full_width: bool,
+      ?loading: bool,
+      ?disabled: bool,
+      ?href: String?,
+      ?icon: String?,
+      ?right_icon: String?,
+      ?type: String,
+      **untyped
+    ) ?{ () -> untyped } -> untyped
 
     # Renders an ODT Badge component.
-    #
-    # @param text [String, nil] Badge label text
-    # @param variant [:subtle, :filled, :outline] Badge style variant (default: :subtle)
-    # @param color [:primary, :secondary, :success, :warning, :danger, :info, :neutral] Badge color (default: :neutral)
-    # @param size [:sm, :md] Badge size (default: :sm)
-    # @param radius [:none, :xs, :sm, :md, :lg, :xl, :"2xl", :"3xl", :"4xl", :full] Border radius (default: :full)
-    # @param dot [bool] Whether to render a leading status dot (default: false)
-    # @param icon [String, nil] Icon class (e.g. 'fa-regular fa-calendar') or SVG string
-    def odt_badge: (?String? text, ?variant: badge_variant, ?color: badge_color, ?size: badge_size, ?radius: radius_size, ?dot: bool, ?icon: String?, **untyped) ?{ () -> untyped } -> untyped
+    def odt_badge: (
+      ?String? text,
+      ?variant: badge_variant,
+      ?color: badge_color,
+      ?size: badge_size,
+      ?radius: radius_size?,
+      ?dot: bool,
+      ?icon: String?,
+      **untyped
+    ) ?{ () -> untyped } -> untyped
 
     # Renders an ODT Card component.
-    #
-    # @param title [String, nil] Card header title
-    # @param subtitle [String, nil] Card header subtitle
-    # @param variant [:elevated, :frosted, :subtle, :muted, :outlined] Surface style variant (default: :frosted)
-    # @param radius [:none, :xs, :sm, :md, :lg, :xl, :"2xl", :"3xl", :"4xl", :full] Corner radius (default: :"3xl")
-    # @param border [bool, Symbol, String] Border styling (default: false)
-    # @param hover [bool] Hover elevation effect (default: true)
-    def odt_card: (?title: String?, ?subtitle: String?, ?variant: card_variant, ?radius: radius_size, ?border: bool | Symbol | String, ?hover: bool, **untyped) ?{ () -> untyped } -> untyped
+    def odt_card: (
+      ?title: String?,
+      ?subtitle: String?,
+      ?variant: card_variant,
+      ?background: card_background?,
+      ?border: card_border?,
+      ?shadow: shadow_size?,
+      ?radius: radius_size?,
+      ?padding: card_padding?,
+      ?hoverable: bool,
+      ?hover: bool,
+      ?as: card_tag,
+      **untyped
+    ) ?{ () -> untyped } -> untyped
 
     # Renders an ODT Alert banner.
-    #
-    # @param message [String, nil] Alert text message
-    # @param variant [:success, :warning, :danger, :info] Alert status variant (default: :success)
-    # @param icon [String, nil] Custom icon class or SVG
-    def odt_alert: (?String? message, ?variant: alert_variant, ?icon: String?, **untyped) ?{ () -> untyped } -> untyped
+    def odt_alert: (
+      ?String? message,
+      ?variant: alert_variant,
+      ?icon: String?,
+      **untyped
+    ) ?{ () -> untyped } -> untyped
 
     # Renders an ODT Heading element.
-    #
-    # @param text [String, nil] Heading text
-    # @param as [:h1, :h2, :h3, :h4, :h5] HTML heading tag (default: :h2)
-    def odt_heading: (?String? text, ?as: heading_tag, **untyped) ?{ () -> untyped } -> untyped
+    def odt_heading: (
+      ?String? text,
+      ?as: heading_tag,
+      ?size: heading_size?,
+      ?weight: font_weight?,
+      ?color: typography_color?,
+      ?truncate: bool,
+      **untyped
+    ) ?{ () -> untyped } -> untyped
 
     # Renders styled body text.
-    #
-    # @param text [String, nil] Body text content
-    # @param color [:default, :strong, :muted, :subtle, :primary] Text color variant (default: :default)
-    # @param size [:xs, :sm, :base, :lg] Text size (default: :base)
-    def odt_text: (?String? text, ?color: text_color, ?size: text_size, **untyped) ?{ () -> untyped } -> untyped
-
-    # Renders an ODT Avatar element with initials or image fallback.
-    #
-    # @param name [String, nil] User name for automatic initials generation
-    # @param src [String, nil] Image avatar URL
-    # @param size [:xs, :sm, :md, :lg, :xl] Avatar size (default: :sm)
-    # @param color [:secondary, :primary, :neutral] Background color theme (default: :secondary)
-    # @param icon [String] Fallback icon if no name or image provided (default: "fa-solid fa-user")
-    def odt_avatar: (?name: String?, ?src: String?, ?size: avatar_size, ?color: avatar_color, ?icon: String, **untyped) -> untyped
+    def odt_text: (
+      ?String? text,
+      ?as: text_tag,
+      ?size: text_size?,
+      ?weight: font_weight?,
+      ?color: typography_color?,
+      ?truncate: bool,
+      **untyped
+    ) ?{ () -> untyped } -> untyped
+
+    # Renders an ODT Avatar element.
+    def odt_avatar: (
+      ?name: String?,
+      ?src: String?,
+      ?size: avatar_size,
+      ?color: avatar_color,
+      ?icon: String,
+      ?fallback: String?,
+      **untyped
+    ) -> untyped
+
+    # Renders a styled input field.
+    def odt_input: (
+      ?label: String?,
+      ?variant: input_variant,
+      ?size: input_size,
+      ?radius: radius_size?,
+      ?type: String,
+      ?placeholder: String?,
+      ?error: String?,
+      ?helper: String?,
+      ?helper_text: String?,
+      ?success: String?,
+      ?left_icon: String?,
+      ?right_icon: String?,
+      ?prefix: String?,
+      ?suffix: String?,
+      ?addon_before: String?,
+      ?addon_after: String?,
+      ?disabled: bool,
+      ?full_width: bool,
+      **untyped
+    ) -> untyped
+
+    # Renders a styled textarea field.
+    def odt_textarea: (
+      ?label: String?,
+      ?variant: input_variant,
+      ?size: input_size,
+      ?radius: radius_size?,
+      ?rows: Integer,
+      ?resize: input_resize,
+      ?error: String?,
+      ?helper: String?,
+      ?helper_text: String?,
+      ?success: String?,
+      ?disabled: bool,
+      ?full_width: bool,
+      **untyped
+    ) ?{ () -> untyped } -> untyped
+
+    # Renders a styled native <select> dropdown.
+    def odt_select: (
+      ?label: String?,
+      ?options: untyped,
+      ?variant: input_variant,
+      ?size: input_size,
+      ?radius: radius_size?,
+      ?prompt: String?,
+      ?error: String?,
+      ?helper: String?,
+      ?helper_text: String?,
+      ?success: String?,
+      ?disabled: bool,
+      ?full_width: bool,
+      **untyped
+    ) -> untyped
+
+    # Renders a styled checkbox.
+    def odt_checkbox: (
+      ?label: String?,
+      ?description: String?,
+      ?checked: bool,
+      ?color: checkbox_color,
+      ?size: checkbox_size,
+      ?radius: radius_size?,
+      ?disabled: bool,
+      ?error: String?,
+      **untyped
+    ) -> untyped
+
+    # Renders a styled radio button.
+    def odt_radio: (
+      ?label: String?,
+      ?description: String?,
+      ?checked: bool,
+      ?color: checkbox_color,
+      ?size: checkbox_size,
+      ?disabled: bool,
+      ?error: String?,
+      **untyped
+    ) -> untyped
+
+    # Renders a form field wrapper.
+    def odt_form_group: (
+      ?label: String?,
+      ?error: String?,
+      ?helper: String?,
+      ?helper_text: String?,
+      ?success: String?,
+      ?required: bool,
+      **untyped
+    ) ?{ () -> untyped } -> untyped
   end
 end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: odt-ui-rails
 version: !ruby/object:Gem::Version
-  version: 2.0.1
+  version: 2.2.0
 platform: ruby
 authors:
 - Pixel
@@ -39,6 +39,7 @@ files:
 - README.md
 - app/assets/stylesheets/odt_ui.css
 - app/assets/stylesheets/odt_ui/styles.css
+- app/assets/stylesheets/odt_ui/theme.css
 - app/assets/stylesheets/odt_ui/tokens.css
 - lib/generators/odt/install_generator.rb
 - lib/odt-ui-rails.rb