m9sh 0.1.0 → 0.2.0

data/PUBLISHING.md

@@ -0,0 +1,331 @@
+# Publishing M9sh Gem to RubyGems
+
+This guide explains how to publish the M9sh gem to RubyGems.org.
+
+## Prerequisites
+
+1. **RubyGems Account**
+   - Create an account at https://rubygems.org/sign_up
+   - Verify your email address
+
+2. **API Key**
+   - Once logged in, go to https://rubygems.org/profile/edit
+   - Copy your API key
+
+3. **Configure RubyGems Credentials**
+   ```bash
+   gem signin
+   # Or manually create ~/.gem/credentials with:
+   # ---
+   # :rubygems_api_key: your_api_key_here
+   ```
+
+## Pre-Publishing Checklist
+
+Before publishing, update these files:
+
+### 1. Update `m9sh.gemspec`
+
+```ruby
+spec.authors = ["Your Name"]
+spec.email = ["your.email@example.com"]
+spec.homepage = "https://github.com/yourusername/m9sh"
+```
+
+### 2. Update URLs in `GEM_README.md`
+
+Replace placeholder URLs with your actual repository URLs.
+
+### 3. Verify Version
+
+Check `lib/m9sh/version.rb`:
+
+```ruby
+module M9sh
+  VERSION = "0.1.0"  # Update as needed
+end
+```
+
+### 4. Update LICENSE
+
+Ensure copyright year and name are correct in `LICENSE.txt`.
+
+## Building the Gem
+
+### 1. Build the Gem Package
+
+```bash
+gem build m9sh.gemspec
+```
+
+This creates `m9sh-0.1.0.gem` in your current directory.
+
+### 2. Test the Gem Locally
+
+Install the gem locally to test:
+
+```bash
+gem install ./m9sh-0.1.0.gem
+```
+
+Test the CLI:
+
+```bash
+m9sh version
+m9sh help
+```
+
+Create a test project:
+
+```bash
+mkdir test-m9sh-project
+cd test-m9sh-project
+m9sh init
+```
+
+### 3. Uninstall Test Gem
+
+```bash
+gem uninstall m9sh
+```
+
+## Publishing to RubyGems
+
+### First Time Publishing
+
+```bash
+# Push the gem to RubyGems
+gem push m9sh-0.1.0.gem
+```
+
+You'll see output like:
+
+```
+Pushing gem to https://rubygems.org...
+Successfully registered gem: m9sh (0.1.0)
+```
+
+### Verify Publication
+
+1. Visit https://rubygems.org/gems/m9sh
+2. Check that your gem is listed
+3. Test installation:
+
+```bash
+gem install m9sh
+m9sh version
+```
+
+## Publishing Updates
+
+### 1. Update Version
+
+Edit `lib/m9sh/version.rb`:
+
+```ruby
+module M9sh
+  VERSION = "0.1.1"  # Increment version
+end
+```
+
+### 2. Update CHANGELOG
+
+Create `CHANGELOG.md` if it doesn't exist and document changes:
+
+```markdown
+## [0.1.1] - 2025-01-XX
+
+### Added
+- New feature description
+
+### Fixed
+- Bug fix description
+
+### Changed
+- Changed behavior description
+```
+
+### 3. Commit Changes
+
+```bash
+git add .
+git commit -m "Bump version to 0.1.1"
+git tag v0.1.1
+git push origin main --tags
+```
+
+### 4. Build and Push
+
+```bash
+gem build m9sh.gemspec
+gem push m9sh-0.1.1.gem
+```
+
+## Yanking a Release
+
+If you need to remove a version:
+
+```bash
+gem yank m9sh -v 0.1.0
+```
+
+**Warning**: Only yank if absolutely necessary (security issues, critical bugs).
+
+## Automated Publishing with GitHub Actions
+
+Create `.github/workflows/publish.yml`:
+
+```yaml
+name: Publish to RubyGems
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v3
+
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '3.0'
+
+      - name: Publish to RubyGems
+        run: |
+          mkdir -p ~/.gem
+          cat > ~/.gem/credentials << EOF
+          ---
+          :rubygems_api_key: ${RUBYGEMS_API_KEY}
+          EOF
+          chmod 0600 ~/.gem/credentials
+          gem build m9sh.gemspec
+          gem push *.gem
+        env:
+          RUBYGEMS_API_KEY: ${{secrets.RUBYGEMS_API_KEY}}
+```
+
+Add your RubyGems API key as a GitHub secret:
+1. Go to your repo → Settings → Secrets → Actions
+2. Add `RUBYGEMS_API_KEY` with your API key
+
+Now publishing is automatic when you push a tag:
+
+```bash
+git tag v0.1.0
+git push origin v0.1.0
+```
+
+## Versioning Strategy
+
+Follow [Semantic Versioning](https://semver.org/):
+
+- **MAJOR** (1.0.0): Breaking changes
+- **MINOR** (0.1.0): New features, backwards compatible
+- **PATCH** (0.0.1): Bug fixes, backwards compatible
+
+Examples:
+- `0.1.0` → `0.1.1`: Bug fix
+- `0.1.0` → `0.2.0`: New component added
+- `0.9.0` → `1.0.0`: Stable API, ready for production
+
+## Post-Publishing Checklist
+
+After publishing:
+
+- [ ] Verify gem appears on RubyGems.org
+- [ ] Test installation: `gem install m9sh`
+- [ ] Verify CLI works: `m9sh version`
+- [ ] Update documentation if needed
+- [ ] Announce on social media/forums
+- [ ] Create GitHub release with changelog
+
+## Troubleshooting
+
+### "You do not have permission to push to this gem"
+
+You're not the owner. Use a different gem name or contact the owner.
+
+### "There was a problem saving your gem"
+
+- Verify gemspec is valid: `gem build m9sh.gemspec`
+- Check all required fields are filled
+- Ensure version is unique (not already published)
+
+### "Invalid gem file"
+
+```bash
+# Rebuild the gem
+rm *.gem
+gem build m9sh.gemspec
+```
+
+### Testing Locally Before Publishing
+
+```bash
+# Build gem
+gem build m9sh.gemspec
+
+# Install locally
+gem install ./m9sh-0.1.0.gem
+
+# Test in a new directory
+cd ~/test-project
+m9sh init
+m9sh add button
+
+# Clean up
+gem uninstall m9sh
+```
+
+## Security
+
+- **Never** commit API keys to git
+- Use `~/.gem/credentials` for API keys
+- Add `*.gem` to `.gitignore`
+- Keep your RubyGems account secure with 2FA
+
+## Resources
+
+- [RubyGems Guides](https://guides.rubygems.org/)
+- [Publishing to RubyGems](https://guides.rubygems.org/publishing/)
+- [Semantic Versioning](https://semver.org/)
+- [GitHub Actions for Ruby](https://github.com/ruby/setup-ruby)
+
+## Maintenance
+
+### Regular Tasks
+
+1. **Monitor Issues** - Respond to GitHub issues
+2. **Update Dependencies** - Keep Thor, ViewComponent updated
+3. **Add Components** - Add new components to registry
+4. **Improve CLI** - Add new CLI features
+5. **Documentation** - Keep docs up to date
+
+### Deprecation Policy
+
+When deprecating features:
+
+1. Add deprecation warning in current version
+2. Update docs to show new approach
+3. Remove in next major version
+4. Document in CHANGELOG
+
+Example:
+
+```ruby
+def old_method
+  warn "[DEPRECATION] `old_method` is deprecated. Use `new_method` instead."
+  new_method
+end
+```
+
+## Support
+
+For questions about publishing:
+- RubyGems Support: https://help.rubygems.org/
+- GitHub Discussions: https://github.com/yourusername/m9sh/discussions

data/README.md

@@ -1,6 +1,6 @@
-# HotCDN - shadcn Components for Rails & Hotwire
+# M9sh - Beautiful UI Components for Rails
 
-Beautiful, accessible UI components for Rails applications using Hotwire, inspired by [shadcn/ui](https://ui.shadcn.com).
+Beautiful, accessible UI components for Rails applications using ViewComponent and Hotwire, inspired by [shadcn/ui](https://ui.shadcn.com).
 
 ## Features
 
@@ -9,7 +9,8 @@ Beautiful, accessible UI components for Rails applications using Hotwire, inspir
 - 🎨 **Tailwind CSS v4** - Modern styling with the latest Tailwind features
 - ♿ **Accessible** - ARIA compliant components
 - 🌙 **Dark Mode** - Built-in dark mode support
-- 📦 **Copy & Paste** - Components you can customize and own
+- 🔧 **CLI Generator** - Powerful CLI for generating components with namespace customization
+- 📦 **Components You Own** - Copy components to your project and customize freely
 
 ## Components
 
@@ -40,43 +41,105 @@ Beautiful, accessible UI components for Rails applications using Hotwire, inspir
 
 ## Installation
 
-1. **Clone the repository**
-   ```bash
-   git clone https://github.com/yourusername/hotcdn.git
-   cd hotcdn
-   ```
+### Option 1: Using the CLI (Recommended)
 
-2. **Install Ruby dependencies**
-   ```bash
-   # Using mise for Ruby version management
-   mise install
-   bundle install
-   ```
+Install the M9sh gem:
 
-3. **Install JavaScript dependencies**
-   ```bash
-   npm install
-   ```
+```bash
+gem install m9sh
+```
+
+Initialize M9sh in your Rails project:
+
+```bash
+m9sh init
+```
+
+Add components as needed:
+
+```bash
+m9sh add button
+m9sh add card
+m9sh add dialog
+# Or add all components at once
+m9sh add --all
+```
+
+### Option 2: Manual Installation
 
-4. **Setup database** (if using Rails with database)
+1. **Clone this repository**
    ```bash
-   rails db:create
-   rails db:migrate
+   git clone https://github.com/veas-org/m9sh.git
+   cd m9sh
    ```
 
-5. **Start the Rails server**
+2. **Install dependencies**
    ```bash
-   rails server
+   bundle install
+   npm install
    ```
 
-6. **In another terminal, start the Tailwind watcher**
+3. **Start the development server**
    ```bash
-   npx tailwindcss -i ./app/assets/stylesheets/application.tailwind.css -o ./app/assets/builds/application.css --watch
+   rails server
    ```
 
-7. **Visit the showcase**
+4. **Visit the showcase**
    Open [http://localhost:3000](http://localhost:3000) to see all components in action.
 
+## Quick Start
+
+### 1. Initialize Configuration
+
+```bash
+m9sh init
+```
+
+This creates a `m9sh.yml` configuration file. You can customize:
+- Component namespace (e.g., `MyApp::UI`)
+- Component directory path
+- JavaScript controller path
+
+### 2. Browse Available Components
+
+```bash
+m9sh list
+```
+
+### 3. Add Components
+
+```bash
+# Add a single component with dependencies
+m9sh add button
+
+# Add multiple components
+m9sh add card dialog tabs
+
+# Get component information
+m9sh info button
+```
+
+### 4. Use in Your Views
+
+Components are automatically generated in your configured namespace:
+
+```erb
+<%= render M9sh::ButtonComponent.new(variant: :primary) do %>
+  Click Me!
+<% end %>
+```
+
+## CLI Commands
+
+- `m9sh init` - Initialize configuration
+- `m9sh add <component>` - Add component with dependencies
+- `m9sh list` - List all available components
+- `m9sh info <component>` - Show component details
+- `m9sh sync <component>` - Update component to latest version
+- `m9sh version` - Show CLI version
+
+For detailed CLI documentation, see [M9SH_CLI.md](./M9SH_CLI.md).
+
 ## Usage
 
 ### Using Components in Your Views
@@ -85,29 +148,30 @@ Components are used via ViewComponent's `render` method:
 
 ```erb
 # Button component
-<%= render Hotcdn::ButtonComponent.new(variant: :primary, size: :lg) do %>
+<%= render M9sh::ButtonComponent.new(variant: :primary, size: :lg) do %>
   Click Me!
 <% end %>
 
 # Card component with slots
-<%= render Hotcdn::CardComponent.new do |card| %>
-  <% card.with_title do %>
-    Card Title
+<%= render M9sh::CardComponent.new do |card| %>
+  <% card.with_header do |header| %>
+    <% header.with_title { "Card Title" } %>
+    <% header.with_description { "Card description" } %>
   <% end %>
-  <% card.with_description do %>
-    Card description
+
+  <% card.with_body do %>
+    Your content here
   <% end %>
-  Your content here
 <% end %>
 
 # Form components
-<%= render Hotcdn::InputComponent.new(
+<%= render M9sh::InputComponent.new(
   type: "email",
   placeholder: "Enter email",
   name: "user[email]"
 ) %>
 
-<%= render Hotcdn::SwitchComponent.new(
+<%= render M9sh::SwitchComponent.new(
   name: "settings[notifications]",
   checked: true
 ) %>
@@ -119,21 +183,21 @@ Components like Accordion, Dialog, and Tabs use Stimulus controllers:
 
 ```erb
 # Accordion
-<%= render Hotcdn::AccordionComponent.new(type: "single", collapsible: true) do |accordion| %>
+<%= render M9sh::AccordionComponent.new(type: "single", collapsible: true) do |accordion| %>
   <% accordion.with_item(value: "item-1") do |item| %>
     <% item.with_trigger do %>
       Click to expand
     <% end %>
-    <% item.with_content do %>
+    <% item.with_body do %>
       Hidden content revealed here
     <% end %>
   <% end %>
 <% end %>
 
 # Dialog/Modal
-<%= render Hotcdn::DialogComponent.new do |dialog| %>
+<%= render M9sh::DialogComponent.new do |dialog| %>
   <% dialog.with_trigger do %>
-    <%= render Hotcdn::ButtonComponent.new do %>
+    <%= render M9sh::ButtonComponent.new do %>
       Open Modal
     <% end %>
   <% end %>
@@ -183,30 +247,34 @@ The theme uses CSS custom properties defined in `app/assets/stylesheets/applicat
 ## Project Structure
 
 ```
-hotcdn/
+m9sh/
 ├── app/
 │   ├── components/
-│   │   └── hotcdn/           # ViewComponent classes
+│   │   └── m9sh/             # ViewComponent classes
 │   │       ├── base_component.rb
 │   │       ├── button_component.rb
 │   │       ├── card_component.rb
 │   │       └── ...
 │   ├── javascript/
 │   │   └── controllers/
-│   │       └── hotcdn/       # Stimulus controllers
+│   │       └── m9sh/         # Stimulus controllers
 │   │           ├── accordion_controller.js
 │   │           ├── dialog_controller.js
 │   │           └── ...
-│   ├── views/
-│   │   └── showcase/         # Demo pages
-│   │       └── index.html.erb
-│   └── assets/
-│       └── stylesheets/
-│           └── application.tailwind.css
-├── config/
-│   ├── routes.rb
-│   └── tailwind.config.js
-└── Gemfile
+│   └── views/
+│       └── showcase/         # Demo pages
+│           └── index.html.erb
+├── lib/
+│   └── m9sh/                 # CLI implementation
+│       ├── cli.rb            # CLI commands
+│       ├── config.rb         # Configuration management
+│       ├── generator.rb      # Component generator
+│       ├── registry.rb       # Component registry
+│       └── registry.yml      # Component definitions
+├── bin/
+│   └── m9sh                  # CLI executable
+├── m9sh.gemspec              # Gem specification
+└── README.md
 ```
 
 ## Contributing

data/app/components/m9sh/accordion_component.rb

@@ -56,7 +56,7 @@ module M9sh
       private
 
       def item_classes
-        "border-b"
+        "border-b border-border"
       end
 
       def render_trigger
@@ -94,11 +94,11 @@ module M9sh
       end
 
       def trigger_classes
-        "flex flex-1 items-center justify-between py-4 text-sm font-medium transition-all hover:underline [&[aria-expanded=true]>svg]:rotate-180"
+        "flex flex-1 items-center justify-between py-4 text-sm font-medium text-foreground transition-all hover:underline [&[aria-expanded=true]>svg]:rotate-180"
       end
 
       def content_classes
-        "overflow-hidden text-sm transition-all duration-300 ease-in-out"
+        "overflow-hidden text-sm text-muted-foreground transition-all duration-300 ease-in-out"
       end
 
       def chevron_icon

data/app/components/m9sh/alert_component.rb

@@ -5,8 +5,8 @@ module M9sh
     include Utilities
 
     VARIANTS = {
-      default: "bg-card text-card-foreground",
-      destructive: "text-destructive bg-card [&>svg]:text-current *:data-[slot=alert-description]:text-destructive/90"
+      default: "bg-background text-foreground",
+      destructive: "border-destructive/50 text-destructive dark:border-destructive [&>svg]:text-destructive"
     }.freeze
 
     renders_one :icon
@@ -36,7 +36,7 @@ module M9sh
     private
 
     def base_classes
-      "relative w-full rounded-lg border px-4 py-3 text-sm grid has-[>svg]:grid-cols-[1rem_1fr] grid-cols-[0_1fr] has-[>svg]:gap-x-3 gap-y-0.5 items-start [&>svg]:size-4 [&>svg]:translate-y-0.5 [&>svg]:text-current"
+      "relative w-full rounded-lg border p-4 [&>svg~*]:pl-7 [&>svg+div]:translate-y-[-3px] [&>svg]:absolute [&>svg]:left-4 [&>svg]:top-4 [&>svg]:text-foreground"
     end
 
     def variant_classes
@@ -46,16 +46,15 @@ module M9sh
     def render_icon
       return unless icon?
 
-      tag.div(class: "col-start-1") { icon }
+      icon
     end
 
     def render_title
       return unless title?
 
-      tag.div(
+      tag.h5(
         title,
-        class: "col-start-2 line-clamp-1 min-h-4 font-medium tracking-tight text-foreground",
-        data: { slot: "alert-title" }
+        class: "mb-1 font-medium leading-none tracking-tight"
       )
     end
 
@@ -64,8 +63,7 @@ module M9sh
 
       tag.div(
         description,
-        class: "text-muted-foreground col-start-2 grid justify-items-start gap-1 text-sm [&_p]:leading-relaxed",
-        data: { slot: "alert-description" }
+        class: "text-sm [&_p]:leading-relaxed"
       )
     end
   end

data/app/components/m9sh/base_component.rb

@@ -5,6 +5,7 @@ module M9sh
     def initialize(class_name: nil, **extra_attrs)
       @class_name = class_name
       @extra_attrs = extra_attrs
+      super()
     end
 
     private

data/app/components/m9sh/button_component.rb

@@ -30,11 +30,12 @@ module M9sh
 
     def call
       tag.button(
-        content,
         **component_attrs(class_names(base_classes, variant_classes, size_classes)),
         type: @type,
         disabled: @disabled
-      )
+      ) do
+        content
+      end
     end
 
     private