loco_motion-rails 0.0.7 → 0.0.8

data/app/components/daisy/navigation/tabs_component.rb

@@ -1,18 +1,103 @@
-# This is the Tabs component.
+#
+# Creates a tabbed navigation component that can be used either as links or radio
+# buttons with associated content.
+#
+# @note When using radio button tabs, the titles must be simple strings and cannot
+#   contain HTML elements or icons.
+#
+# @slot tabs+ {Daisy::Navigation::TabsComponent::TabComponent} The individual
+#   tabs to display.
+#
+# @example Basic tabs with links
+#   = daisy_tabs(css: "tabs-bordered") do |tabs|
+#     - tabs.with_tab(title: "Home", active: true)
+#     - tabs.with_tab(title: "Click Me", html: { onclick: "alert('Clicked!')" })
+#     - tabs.with_tab(title: "Google", href: "https://google.com", target: "_blank")
+#
+# @example Radio button tabs with content
+#   = daisy_tabs(css: "tabs-lifted", radio: true) do |tabs|
+#     - tabs.with_tab(title: "Tab 1", checked: true) do
+#       %p Tab 1 content
+#     - tabs.with_tab(title: "Tab 2") do
+#       %p Tab 2 content
+#
+# @example Tabs with custom titles and content
+#   = daisy_tabs(css: "tabs-lifted") do |tabs|
+#     - tabs.with_tab do |tab|
+#       - tab.with_title do
+#         .flex.gap-2
+#           = hero_icon("home")
+#           Home
+#       - tab.with_custom_content(css: "tab-content p-4") do
+#         %p Welcome home!
+#
 class Daisy::Navigation::TabsComponent < LocoMotion::BaseComponent
 
+  #
+  # A tab within a TabsComponent that can be either a link or a radio button.
+  #
+  # @part content_wrapper The wrapper for the tab's content when not using
+  #   custom content.
+  #
+  # @slot title The title content for the tab. Only used if no `title` option
+  #   is provided.
+  #
+  # @slot custom_content Custom content to be rendered after the tab. Use this
+  #   instead of the block content for complete control over the content's HTML.
+  #
+  # @example Basic tab with title
+  #   = tabs.with_tab(title: "Home")
+  #
+  # @example Tab with custom title
+  #   = tabs.with_tab do |tab|
+  #     - tab.with_title do
+  #       .flex.gap-2
+  #         = hero_icon("home")
+  #         Home
+  #
+  # @example Tab with content
+  #   = tabs.with_tab(title: "Content") do
+  #     %p This is the tab's content
+  #
+  # @example Tab with custom content
+  #   = tabs.with_tab do |tab|
+  #     - tab.with_custom_content(css: "tab-content p-4") do
+  #       %p Custom content with custom wrapper
+  #
   class TabComponent < LocoMotion::BasicComponent
     define_parts :content_wrapper
 
     renders_one :title
     renders_one :custom_content
 
-    attr_reader :active
-
-    # @return [String] Accessor for the `title` string passed via the component
-    #   config.
-    attr_reader :simple_title
-
+    attr_reader :active, :simple_title
+
+    # Create a new instance of the TabComponent.
+    #
+    # @param args [Array] Not used.
+    #
+    # @param kws [Hash] The keyword arguments for the component.
+    #
+    # @option kws title [String] The text to display in the tab.
+    #
+    # @option kws active [Boolean] Whether this tab is active (default: false).
+    #
+    # @option kws checked [Boolean] Whether this tab is checked (default: false).
+    #
+    # @option kws disabled [Boolean] Whether this tab is disabled (default: false).
+    #
+    # @option kws href [String] The URL to visit when the tab is clicked.
+    #
+    # @option kws target [String] The target attribute for the tab (e.g., "_blank").
+    #
+    # @option kws value [String] The value attribute when using radio buttons.
+    #
+    # @option kws css [String] Additional CSS classes for styling. Common
+    #   options include:
+    #   - Size: `tab-lg`, `tab-md`, `tab-sm`, `tab-xs`
+    #   - Width: `w-full`, `!w-14`
+    #   - Cursor: `cursor-pointer`, `!cursor-auto`
+    #
     def initialize(*args, **kws, &block)
       super
 
@@ -88,6 +173,24 @@ class Daisy::Navigation::TabsComponent < LocoMotion::BaseComponent
 
   attr_reader :name, :radio
 
+  # Create a new instance of the TabsComponent.
+  #
+  # @param args [Array] Not used.
+  #
+  # @param kws [Hash] The keyword arguments for the component.
+  #
+  # @option kws name [String] The name attribute for radio button tabs
+  #   (default: auto-generated UUID).
+  #
+  # @option kws radio [Boolean] Whether to use radio buttons instead of links
+  #   (default: false).
+  #
+  # @option kws css [String] Additional CSS classes for styling. Common
+  #   options include:
+  #   - Style: `tabs-bordered`, `tabs-lifted`
+  #   - Size: `tabs-lg`, `tabs-md`, `tabs-sm`, `tabs-xs`
+  #   - Width: `w-full`, `w-[500px]`
+  #
   def initialize(*args, **kws, &block)
     super
 

data/app/components/hero/icon_component.rb

@@ -1,6 +1,46 @@
+#
+# Creates an icon component using Heroicons, a set of free, MIT-licensed
+# high-quality SVG icons. For a complete list of available icons, visit
+# https://heroicons.com.
+#
+# @note By default, icons are displayed with the `size-5` Tailwind class. This
+#   can be overridden without using the `!` modifier because we utilize the
+#   `:where()` pseudo-class to ensure our default classes have the lowest CSS
+#   specificity.
+#
+# @example Basic icon usage
+#   = hero_icon("academic-cap")
+#   = hero_icon(icon: "adjustments-horizontal")
+#   %span.text-blue-500
+#     = hero_icon("archive-box")
+#
+# @example Customized icons
+#   = hero_icon("no-symbol", css: "size-4 text-red-600")
+#   = hero_icon("arrow-trending-up", css: "size-10 text-green-600")
+#   = hero_icon("exclamation-triangle", css: "size-14 text-yellow-400 animate-pulse")
+#
 class Hero::IconComponent < LocoMotion::BaseComponent
   prepend LocoMotion::Concerns::TippableComponent
 
+  # Create a new instance of the IconComponent.
+  #
+  # @param args [Array] If provided, the first argument is considered the
+  #   `icon` name.
+  #
+  # @param kws [Hash] The keyword arguments for the component.
+  #
+  # @option kws icon [String] The name of the icon to display. See
+  #   https://heroicons.com for available icons.
+  #
+  # @option kws variant [Symbol] The variant of the icon to use
+  #   (default: :outline).
+  #
+  # @option kws css [String] Additional CSS classes for styling. Common
+  #   options include:
+  #   - Size: `size-4`, `size-10`, `size-14`
+  #   - Color: `text-red-600`, `text-green-600`, `text-yellow-400`
+  #   - Animation: `animate-pulse`, `animate-spin`
+  #
   def initialize(*args, **kws, &block)
     super
 

data/lib/daisy.rb

@@ -26,4 +26,9 @@ module Daisy
   # Holds all Layout-type components.
   #
   module Layout; end
+
+  #
+  # Holds all Mockup-type components.
+  #
+  module Mockup; end
 end

data/lib/loco_motion/helpers.rb

@@ -23,6 +23,7 @@ module LocoMotion
     "Daisy::DataDisplay::CollapseComponent" => { names: "collapse", group: "Data", title: "Collapses", example: "collapses" },
     "Daisy::DataDisplay::CountdownComponent" => { names: "countdown", group: "Data", title: "Countdowns", example: "countdowns" },
     "Daisy::DataDisplay::DiffComponent" => { names: "diff", group: "Data", title: "Diffs", example: "diffs" },
+    "Daisy::DataDisplay::FigureComponent" => { names: "figure", group: "Data", title: "Figures", example: "figures" },
     "Daisy::DataDisplay::KbdComponent" => { names: "kbd", group: "Data", title: "Keyboard (KBD)", example: "kbds" },
     "Daisy::DataDisplay::StatComponent" => { names: "stat", group: "Data", title: "Stats", example: "stats" },
     "Daisy::DataDisplay::TableComponent" => { names: "table", group: "Data", title: "Tables", example: "tables" },
@@ -57,6 +58,12 @@ module LocoMotion
     "Daisy::Layout::JoinComponent" => { names: "join", group: "Layout", title: "Joins", example: "joins" },
     "Daisy::Layout::MaskComponent" => { names: nil, group: "Layout", title: "Masks", example: "masks" },
     "Daisy::Layout::StackComponent" => { names: "stack", group: "Layout", title: "Stacks", example: "stacks" },
+
+    # Mockup
+    "Daisy::Mockup::BrowserComponent" => { names: "browser", group: "Mockup", title: "Browsers", example: "browsers" },
+    "Daisy::Mockup::CodeComponent" => { names: "code", group: "Mockup", title: "Code Blocks", example: "code_blocks" },
+    "Daisy::Mockup::DeviceComponent" => { names: "device", group: "Mockup", title: "Devices", example: "devices" },
+    "Daisy::Mockup::FrameComponent" => { names: "frame", group: "Mockup", title: "Frames", example: "frames" },
   }
 
   module Helpers

data/lib/loco_motion/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module LocoMotion
+  VERSION = "0.0.8"
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: loco_motion-rails
 version: !ruby/object:Gem::Version
-  version: 0.0.7
+  version: 0.0.8
 platform: ruby
 authors:
 - Topher Fangio
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-11-19 00:00:00.000000000 Z
+date: 2025-03-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: haml-rails
@@ -42,14 +42,14 @@ dependencies:
   name: rails
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '6.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '6.1'
 - !ruby/object:Gem::Dependency
@@ -220,6 +220,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.2'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.15.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.15.0
 - !ruby/object:Gem::Dependency
   name: rails
   requirement: !ruby/object:Gem::Requirement
@@ -360,6 +374,7 @@ files:
 - app/components/daisy/data_display/countdown_controller.js
 - app/components/daisy/data_display/diff_component.html.haml
 - app/components/daisy/data_display/diff_component.rb
+- app/components/daisy/data_display/figure_component.rb
 - app/components/daisy/data_display/kbd_component.rb
 - app/components/daisy/data_display/stat_component.html.haml
 - app/components/daisy/data_display/stat_component.rb
@@ -387,6 +402,10 @@ files:
 - app/components/daisy/layout/indicator_component.rb
 - app/components/daisy/layout/join_component.rb
 - app/components/daisy/layout/stack_component.rb
+- app/components/daisy/mockup/browser_component.rb
+- app/components/daisy/mockup/code_component.rb
+- app/components/daisy/mockup/device_component.rb
+- app/components/daisy/mockup/frame_component.rb
 - app/components/daisy/navigation/bottom_nav_component.rb
 - app/components/daisy/navigation/breadcrumbs_component.html.haml
 - app/components/daisy/navigation/breadcrumbs_component.rb
@@ -410,6 +429,7 @@ files:
 - lib/loco_motion/engine.rb
 - lib/loco_motion/errors.rb
 - lib/loco_motion/helpers.rb
+- lib/loco_motion/version.rb
 homepage: https://rubygems.org/gems/loco_motion-rails
 licenses:
 - MIT
@@ -423,7 +443,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '3.0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="