Merge pull request #27 from sean-yeoh/dev

Release v0.1.19

Author: sean-yeoh

.github/workflows/ci.yml

@@ -29,7 +29,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        ruby: ['3.3', '3.4', 'head']
+        ruby: ['3.4', 'head']
     steps:
       - uses: actions/checkout@v4
       - uses: ruby/setup-ruby@v1
@@ -38,14 +38,15 @@ jobs:
           bundler: latest
           bundler-cache: true
       - name: Run tests
+        env:
+          TZ: UTC
         run: bundle exec rake test
 
   user-install:
     strategy:
       fail-fast: false
       matrix:
         plat: ['ubuntu', 'macos']
-        # plat: ['ubuntu', 'windows', 'macos']
     runs-on: ${{matrix.plat}}-latest
     steps:
       - uses: actions/checkout@v4
@@ -56,6 +57,21 @@ jobs:
       - run: test/integration/user_install_test.sh
         shell: bash
 
+  user-upgrade:
+    strategy:
+      fail-fast: false
+      matrix:
+        plat: ['ubuntu', 'macos']
+    runs-on: ${{matrix.plat}}-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '3.4'
+          bundler: latest
+      - run: test/integration/user_upgrade_test.sh
+        shell: bash
+
   check-release-version:
     if: github.head_ref == 'dev' && github.base_ref == 'main'
     runs-on: ubuntu-latest

CHANGELOG.md

@@ -1,18 +1,20 @@
-## [Unreleased] - YYYY-MM-DD
+## [Unreleased] - 2025-08-01
+
 ### Added
+
+- Upgrade task
+- Ability to configure components
+
 ### Changed
-### Deprecated
-### Removed
-### Fixed
-### Security
+
+- Stimulus controllers initialization
 
 ## [0.1.17] - 2025-07-08
 
 ### Fixed
 
 - Combobox search_placeholder_text
 
-
 ## [0.1.16] - 2025-07-08
 
 ### Fixed

CLAUDE.md

@@ -0,0 +1,77 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+This is a Ruby gem called `shadcn_phlexcomponents` - a UI component library for Ruby on Rails that provides Shadcn-style components built with Phlex. The library includes interactive JavaScript controllers using Stimulus and Tailwind CSS for styling.
+
+## Architecture
+
+### Core Structure
+- **Ruby Components**: Located in `lib/shadcn_phlexcomponents/components/` - each component inherits from `Base` class
+- **JavaScript Controllers**: Located in `app/javascript/controllers/` - Stimulus controllers that provide interactivity
+- **Stylesheets**: Located in `app/javascript/stylesheets/` - component-specific CSS
+- **Base Component**: `lib/shadcn_phlexcomponents/components/base.rb` provides common functionality including:
+  - Phlex::HTML integration
+  - TailwindMerge for class merging
+  - Sanitization helpers for SVG icons
+  - Class variants system
+  - Lucide Rails icon integration
+
+### Component Pattern
+Components follow a dual-layer architecture:
+1. Ruby Phlex components for HTML structure and styling
+2. Stimulus controllers for JavaScript behavior and interactivity
+
+### Key Dependencies
+- **Class Variants** (~> 1.1): For configuring different variants of css classes
+- **Phlex Rails** (~> 2.1): For component rendering
+- **Lucide Rails** (~> 0.5.1): For icons
+- **TailwindMerge** (~> 1.0): For CSS class merging
+- **Rails** (~> 8.0): Host framework
+
+## Development Commands
+
+### Testing
+```bash
+rake test          # Run all tests
+```
+
+### Linting
+```bash
+rake rubocop       # Run RuboCop linter
+rubocop            # Direct RuboCop execution
+```
+
+### Development Setup
+```bash
+bin/setup          # Install dependencies
+bin/console        # Interactive Ruby console
+```
+
+### Gem Management
+```bash
+bundle exec rake install    # Install gem locally
+bundle exec rake release    # Release new version
+rake                        # Default task (test + rubocop)
+```
+
+## Component Development
+
+### Adding New Components
+1. Create Ruby component in `lib/shadcn_phlexcomponents/components/`
+2. If interactive, create corresponding Stimulus controller in `app/javascript/controllers/`
+3. Add any component-specific CSS to `app/javascript/stylesheets/`
+4. Components should inherit from `ShadcnPhlexcomponents::Base`
+
+### Styling Guidelines
+- Use Tailwind CSS classes
+- Leverage the `TAILWIND_MERGER` for class merging
+- Follow existing component patterns for consistency
+- Use `class_variants` system for component variations
+
+### JavaScript Controllers
+- Use Stimulus framework
+- Controllers should be named `[component_name]_controller.ts`
+- Follow existing controller patterns for data attributes and targets

Gemfile

@@ -13,6 +13,8 @@ gem "rubocop-minitest", "~> 0.37.0", require: false
 gem "rubocop-shopify", "~> 2.16", require: false
 gem "debug", platforms: [:mri, :windows]
 gem "phlex-rails", "~> 2.1"
-gem "rails", "~> 8.0"
 gem "lucide-rails", "~> 0.5.1"
 gem "tailwind_merge", "~> 1.0"
+gem "class_variants", "~> 1.1"
+gem "rails", "~> 8.0"
+gem "nokogiri", "~> 1.0"